Core#

ansys.dpf.core.core.load_library(filename, name='', symbol='LoadOperators', server=None)#

Dynamically load an operators library for dpf.core. Code containing this library’s operators is generated in ansys.dpf.core.operators

Parameters

filename (str or os.PathLike) – Filename of the operator library.
name (str, optional) – Library name. Probably optional
server (server.DPFServer, optional) – Server with channel connected to the remote or local instance. When None, attempts to use the the global server.

Examples

Load the mesh operators for Windows (for Linux, just use ‘libmeshOperatorsCore.so’ instead of ‘meshOperatorsCore.dll’)

>>> from ansys.dpf import core as dpf
>>> # dpf.load_library('meshOperatorsCore.dll', 'mesh_operators')

ansys.dpf.core.core.upload_file_in_tmp_folder(file_path, new_file_name=None, server=None)#

Upload a file from the client to the server in a temporary folder deleted when the server is shutdown

Parameters

file_path (str or os.PathLike) – file path on the client side to upload
new_file_name (str, optional) – name to give to the file server side, if no name is specified, the same name as the input file is given
server (server.DPFServer, optional) – Server with channel connected to the remote or local instance. When None, attempts to use the the global server.

Returns

server_file_path – path generated server side

Return type

str

Notes

Print a progress bar

Examples

>>> from ansys.dpf import core as dpf
>>> from ansys.dpf.core import examples
>>> file_path = dpf.upload_file_in_tmp_folder(examples.static_rst)

ansys.dpf.core.core.upload_files_in_folder(to_server_folder_path, client_folder_path, specific_extension=None, server=None)#

Upload all the files from a folder of the client to the target server folder path.

Parameters

to_server_folder_path (str or os.PathLike) – folder path target where will be uploaded files on the server side
client_folder_path (str or os.PathLike) – folder path where the files that must be uploaded are located on client side
(optional) (specific_extension) – copies only the files with the given extension
server (server.DPFServer, optional) – Server with channel connected to the remote or local instance. When None, attempts to use the the global server.

Returns

paths – new file paths server side

Return type

list of str

ansys.dpf.core.core.download_file(server_file_path, to_client_file_path, server=None)#

Download a file from the server to the target client file path

Parameters

server_file_path (str or os.PathLike) – file path to download on the server side
to_client_file_path (str or os.PathLike) – file path target where the file will be located client side
server (server.DPFServer, optional) – Server with channel connected to the remote or local instance. When None, attempts to use the the global server.

Notes

Print a progress bar

Examples

>>> from ansys.dpf import core as dpf
>>> from ansys.dpf.core import examples
>>> import os
>>> file_path = dpf.upload_file_in_tmp_folder(examples.static_rst)
>>> dpf.download_file(file_path, examples.static_rst)

ansys.dpf.core.core.download_files_in_folder(server_folder_path, to_client_folder_path, specific_extension=None, server=None)#

Download all the files from a folder of the server to the target client folder path

Parameters

server_folder_path (str or os.PathLike) – folder path to download on the server side
to_client_folder_path (str or os.PathLike) – folder path target where the files will be located client side
(optional) (specific_extension) – copies only the files with the given extension
server (server.DPFServer, optional) – Server with channel connected to the remote or local instance. When None, attempts to use the the global server.

Returns

paths – new file paths client side

Return type

list of str

Notes

Print a progress bar

ansys.dpf.core.core.upload_file(file_path, to_server_file_path, server=None)#

Upload a file from the client to the target server file path

Parameters

file_path (str or os.PathLike) – file path on the client side to upload
to_server_file_path (str or os.PathLike) – file path target where the file will be located server side
server (server.DPFServer, optional) – Server with channel connected to the remote or local instance. When None, attempts to use the the global server.

Notes

Print a progress bar

Returns: server_file_path – path generated server side
Return type: str

ansys.dpf.core.core.make_tmp_dir_server(server=None)#

Create a temporary folder server side. Only one temporary folder can be created by server instance. The folder will be deleted when the server is stopped.

Parameters: server (server.DPFServer, optional) – Server with channel connected to the remote or local instance. When None, attempts to use the the global server.
Returns: path – path to the temporary dir
Return type: str

class ansys.dpf.core.core.BaseService(server=None, load_operators=True, timeout=5)#

The Base Service class allows to make generic requests to dpf’s server. For example, information about the server can be requested, uploading/downloading file from and to the server can be done, new operators plugins can be loaded… Most of the request done by the BaseService class are wrapped by functions.

Parameters

server (server.DPFServer, optional) – Server with channel connected to the remote or local instance. When None, attempts to use the the global server.
timeout (float, optional) – Fails when a connection takes longer than timeout seconds to initialize.
load_operators (bool, optional) – Automatically load the math operators

Examples

Connect to an existing DPF server >>> from ansys.dpf import core as dpf >>> #server = dpf.connect_to_server(ip=’127.0.0.1’, port = 50054, as_global=False) >>> #base = dpf.BaseService(server=server)

make_tmp_dir_server()#

Create a temporary folder server side. Only one temporary folder can be created by server instance. The folder will be deleted when the server is stopped.

Returns: path – path to the temporary dir
Return type: str

load_library(file_path, name='', symbol='LoadOperators')#

Dynamically load an operators library for dpf.core. Code containing this library’s operators is generated in ansys.dpf.core.operators

Parameters

file_path (str or os.PathLike) – file_path of the operator library.
name (str, optional) – Library name. Probably optional

Examples

Load the mesh operators for Windows (for Linux, just use ‘libmeshOperatorsCore.so’ instead of ‘meshOperatorsCore.dll’)

>>> from ansys.dpf import core as dpf
>>> base = dpf.BaseService()
>>> # base.load_library('meshOperatorsCore.dll', 'mesh_operators')

property server_info#

Send the request for server information and keep the info into a dictionary

Returns: info – dictionary with “server_ip”, “server_port”, “server_process_id” “server_version” keys
Return type: dictionary

download_file(server_file_path, to_client_file_path)#

Download a file from the server to the target client file path

Parameters

server_file_path (str or os.PathLike) – file path to download on the server side
to_client_file_path (str or os.PathLike) – file path target where the file will be located client side

Notes

Print a progress bar

download_files_in_folder(server_folder_path, to_client_folder_path, specific_extension=None)#

Download all the files from a folder of the server to the target client folder path

Parameters

server_folder_path (str or os.PathLike) – folder path to download on the server side
to_client_folder_path (str or os.PathLike) – folder path target where the files will be located client side
(optional) (specific_extension) – copies only the files with the given extension

Returns

paths – new file paths client side

Return type

list of str

Notes

Print a progress bar

upload_files_in_folder(to_server_folder_path, client_folder_path, specific_extension=None)#

Upload all the files from a folder of the client to the target server folder path.

Parameters

to_server_folder_path (str or os.PathLike) – folder path target where will be uploaded files on the server side
client_folder_path (str or os.PathLike) – folder path where the files that must be uploaded are located on client side
(optional) (specific_extension) – copies only the files with the given extension

Returns

paths – new file paths server side

Return type

list of str

upload_file(file_path, to_server_file_path)#

Upload a file from the client to the target server file path

Parameters

file_path (str or os.PathLike) – file path on the client side to upload
to_server_file_path (str or os.PathLike) – file path target where the file will be located server side

Returns

server_file_path – path generated server side

Return type

str

Notes

Print a progress bar

upload_file_in_tmp_folder(file_path, new_file_name=None)#

Upload a file from the client to the server in a temporary folder deleted when the server is shutdown

Parameters

file_path (str or os.PathLike) – file path on the client side to upload
new_file_name (str, optional) – name to give to the file server side, if no name is specified, the same name as the input file is given

Notes

Print a progress bar

Returns: server_file_path – path generated server side
Return type: str