PyFluent文档｜03 指定文件路径

功能：从 ANSYS 示例数据仓库下载示例数据集。

异常：RemoteFileNotFoundError(url)：尝试下载不存在的远程文件时引发。

函数：

• delete_downloads()：删除默认示例文件夹中的所有已下载示例，以释放空间或更新文件。
• download_file(file_name[, directory, ...])：从 Ansys 示例数据仓库下载指定的示例文件。
• path(file_name)：返回给定文件名的路径。

 

异常 ansys.fluent.core.examples.downloads.RemoteFileNotFoundError(url)

”

• 基类：FileNotFoundError
• 尝试下载不存在的远程文件时引发。
• __init__(url)：构造函数。

 

ansys.fluent.core.examples.downloads.delete_downloads()

”

从默认示例文件夹中删除所有已下载示例，以便释放空间或更新文件。

 

注意：默认示例路径由 pyfluent.EXAMPLES_PATH 给出。

”

 

ansys.fluent.core.examples.downloads.download_file(file_name, directory=None, save_path=None, return_without_path=None)

”

从 ANSYS 示例数据仓库下载指定的示例文件。

参数：

• file_name：str

  要下载的文件名。

• directory：str, 可选

  指定文件所在 Ansys 示例数据仓库的目录。如果不指定，则在仓库的根目录中查找文件。

• save_path：str, 可选

  指定文件的下载路径。

• return_without_path：bool, 可选

  默认为 False，除非设置了环境变量 PYFLUENT_LAUNCH_CONTAINER=1，此时默认为 True。当使用 Fluent Docker 容器镜像时尤为重要，因为从主机侧导入的文件的完整路径不一定与容器内 Fluent 中的路径相同。假设容器内的 Fluent 工作目录设置为从主机挂载的路径，并且示例文件通过该路径由主机提供，则 Fluent 查找和打开文件时仅需文件名。

返回：

• str下载或已存在的文件的文件路径，如果 return_without_path=True 则只返回文件名。
• 异常RemoteFileNotFoundError：如果远程文件不存在。

Examples

>>> from ansys.fluent.core import examples
>>> file_path = examples.download_file("bracket.iges", "geometry")
>>> file_path
'/home/user/.local/share/ansys_fluent_core/examples/bracket.iges'
>>> file_name = examples.download_file("bracket.iges", "geometry", return_without_path=True)
>>> file_name
'bracket.iges'
>>> file_path = examples.download_file("bracket.iges", "geometry", save_path='.')
'/home/<current_folder_path>/bracket.iges'
>>> file_name = examples.download_file("bracket.iges", "geometry", save_path='.', return_without_path=True)
>>> file_name
'bracket.iges'
>>> file_path = examples.download_file("bracket.iges", "geometry", save_path='<user_specified_path>')
'/home/<user_specified_path>/bracket.iges'
>>> file_name = examples.download_file("bracket.iges", "geometry", save_path='<user_specified_path>',
                                  return_without_path=True)
>>> file_name
'bracket.iges'

 

ansys.fluent.core.examples.downloads.path(file_name)

”

• 功能：

  返回给定文件名的路径。

• 参数：

• file_name：str文件名。

• 返回：

• file_path：str文件路径。

• 异常：

• FileNotFoundError：如果文件不存在。