Skip to content

Commit 2d863c3

Browse files
updates in the DataSources api reference
1 parent 30e411f commit 2d863c3

File tree

1 file changed

+2
-75
lines changed

1 file changed

+2
-75
lines changed

src/ansys/dpf/core/data_sources.py

Lines changed: 2 additions & 75 deletions
Original file line numberDiff line numberDiff line change
@@ -202,33 +202,6 @@ def add_file_path(
202202
Files not added as main result files are accessory files, which contain accessory
203203
information not present in the main result files.
204204
205-
Parameters
206-
----------
207-
filepath :
208-
Path of the file.
209-
key :
210-
Extension of the file, which is used as a key for choosing the correct
211-
plugin when a result is requested by an operator. The default is ``""``,
212-
in which case the key is found directly.
213-
is_domain :
214-
Whether the file path is the domain path. The default is ``False``.
215-
domain_id :
216-
Domain ID for the distributed files. The default is ``0``. For this
217-
parameter to be taken into account, ``domain_path=True`` must be set.
218-
219-
Examples
220-
--------
221-
Add an accessory file to the DataSources object
222-
223-
>>> from ansys.dpf import core as dpf
224-
>>>
225-
>>> # Create the DataSources object
226-
>>> my_data_sources = dpf.DataSources()
227-
>>> # Define the path where the main result file can be found
228-
>>> my_data_sources.set_result_file_path(filepath='/tmp/file.cas', key='cas')
229-
>>> # Add the additional result file to the DataSources object
230-
>>> my_data_sources.add_file_path(filepath='/tmp/ds.dat', key='dat')
231-
232205
"""
233206
# The filename needs to be a fully qualified file name
234207
if not os.path.dirname(filepath):
@@ -250,35 +223,7 @@ def add_file_path(
250223
def add_domain_file_path(
251224
self, filepath: Union[str, os.PathLike], key: str, domain_id: int
252225
) -> None:
253-
"""Add a file path to the data sources in the given domain.
254-
255-
Files not added as main result files are accessory files, which contain accessory
256-
information not present in the main result files.
257-
258-
Parameters
259-
----------
260-
filepath :
261-
Path of the file.
262-
key :
263-
Extension of the file, which is used as a key for choosing the correct
264-
plugin when a result is requested by an operator.
265-
domain_id :
266-
Domain ID for the distributed files.
267-
268-
Examples
269-
--------
270-
Add an accessory file to its domain
271-
272-
>>> from ansys.dpf import core as dpf
273-
>>>
274-
>>> # Create the DataSources object
275-
>>> my_data_sources = dpf.DataSources()
276-
>>> # Define the path where the main result data can be found and specify its domain
277-
>>> my_data_sources.set_domain_result_file_path(path='/tmp/ds.cas', key='cas', domain_id=1)
278-
>>> # Add the additional result data to the DataSources object and specify its domain
279-
>>> my_data_sources.add_domain_file_path(filepath='/tmp/ds.dat', key="dat", domain_id=1)
280-
281-
"""
226+
"""Add a file path to the data sources in the given domain."""
282227
# The filename needs to be a fully qualified file name
283228
if not os.path.dirname(filepath):
284229
# append local path
@@ -293,25 +238,7 @@ def add_file_path_for_specified_result(
293238
key: Optional[str] = "",
294239
result_key: Optional[str] = "",
295240
):
296-
"""Add a file path for a specified result file key to the data sources.
297-
298-
This method can be used when results files with different keys (extensions) are
299-
contained in the data sources. For example, a solve using two different solvers
300-
could generate two different sets of files.
301-
302-
Parameters
303-
----------
304-
filepath :
305-
Path of the file.
306-
key :
307-
Extension of the file, which is used as a key for choosing the correct
308-
plugin when a result is requested by an operator. The default is ``""``,
309-
in which case the key is found directly.
310-
result_key :
311-
Extension of the results file that the specified file path belongs to.
312-
The default is ``""``, in which case the key is found directly.
313-
314-
"""
241+
"""Add a file path for a specified result file key to the data sources."""
315242
# The filename needs to be a fully qualified file name
316243
if not os.path.dirname(filepath):
317244
# append local path

0 commit comments

Comments
 (0)