ansys-pyensight-core 0.10.2__py3-none-any.whl → 0.10.3__py3-none-any.whl

ansys/pyensight/core/libuserd.py

@@ -1983,7 +1983,7 @@ class LibUserd(object):
         return output
 
     @staticmethod
-    def _download_files(uri: str, pathname: str, folder: bool = False):
+    def _download_files(uri: str, pathname: str, folder: bool = False, override_root: bool = False):
         """Download files from the input uri and save them on the input pathname.
 
         Parameters:
@@ -1996,9 +1996,21 @@ class LibUserd(object):
         folder : bool
             True if the uri will server files from a directory. In this case,
             pathname will be used as the directory were to save the files.
+        override_root: bool
+            True if the root has been overridden. So don't consider the case
+            of getting the download URL from the github API
         """
         if not folder:
-            with requests.get(uri, stream=True) as r:
+            if override_root:
+                correct_url = uri
+            else:
+                correct_url = None
+                with requests.get(uri) as r:
+                    data = r.json()
+                    correct_url = data["download_url"]
+                if not correct_url:
+                    raise RuntimeError(f"Couldn't retrieve download URL from github uri {uri}")
+            with requests.get(correct_url, stream=True) as r:
                 with open(pathname, "wb") as f:
                     shutil.copyfileobj(r.raw, f)
         else:
@@ -2054,13 +2066,12 @@ class LibUserd(object):
         >>> cas_file = l.download_pyansys_example("mixing_elbow.cas.h5","pyfluent/mixing_elbow")
         >>> dat_file = l.download_pyansys_example("mixing_elbow.dat.h5","pyfluent/mixing_elbow")
         """
-        base_uri = "https://github.com/ansys/example-data/raw/master"
-        base_api_uri = "https://api.github.com/repos/ansys/example-data/contents"
+        base_uri = "https://api.github.com/repos/ansys/example-data/contents"
+        override_root = False
         if not folder:
             if root is not None:
                 base_uri = root
-        else:
-            base_uri = base_api_uri
+                override_root = True
         uri = f"{base_uri}/{filename}"
         if directory:
             uri = f"{base_uri}/{directory}/{filename}"
@@ -2069,7 +2080,7 @@ class LibUserd(object):
         if self._container and self._data_directory:
             # Docker Image
             download_path = os.path.join(self._data_directory, filename)
-        self._download_files(uri, download_path, folder=folder)
+        self._download_files(uri, download_path, folder=folder, override_root=override_root)
         pathname = download_path
         if self._container:
             # Convert local path to Docker mounted volume path

ansys/pyensight/core/session.py

@@ -1278,22 +1278,30 @@ class Session:
         >>> remote = session.show("remote")
         >>> remote.browser()
         """
-        base_uri = "https://github.com/ansys/example-data/raw/master"
-        base_api_uri = "https://api.github.com/repos/ansys/example-data/contents"
+        base_uri = "https://api.github.com/repos/ansys/example-data/contents"
+        override_root = False
         if not folder:
             if root is not None:
                 base_uri = root
-        else:
-            base_uri = base_api_uri
+                override_root = True
         uri = f"{base_uri}/{filename}"
         if directory:
             uri = f"{base_uri}/{directory}/{filename}"
         pathname = f"{self.launcher.session_directory}/{filename}"
         if not folder:
+            if override_root:
+                correct_url = uri
+            else:
+                correct_url = None
+                with requests.get(uri) as r:
+                    data = r.json()
+                    correct_url = data["download_url"]
+                if not correct_url:
+                    raise RuntimeError(f"Couldn't retrieve download URL from github uri {uri}")
             script = "import requests\n"
             script += "import shutil\n"
             script += "import os\n"
-            script += f'url = "{uri}"\n'
+            script += f'url = "{correct_url}"\n'
             script += f'outpath = r"""{pathname}"""\n'
             script += "with requests.get(url, stream=True) as r:\n"
             script += "    with open(outpath, 'wb') as f:\n"

ansys/pyensight/core/utils/omniverse.py

@@ -47,12 +47,12 @@ class OmniverseKitInstance:
             if psutil.pid_exists(child.pid):
                 # This can be a race condition, so it is ok if the child is dead already
                 try:
-                    child.kill()
+                    child.terminate()
                 except psutil.NoSuchProcess:
                     pass
         # Same issue, this process might already be shutting down, so NoSuchProcess is ok.
         try:
-            proc.kill()
+            proc.terminate()
         except psutil.NoSuchProcess:
             pass
         self._pid = None
@@ -73,6 +73,7 @@ class OmniverseKitInstance:
         return False
 
 
+# Deprecated
 def find_kit_filename(fallback_directory: Optional[str] = None) -> Optional[str]:
     """
     Use a combination of the current omniverse application and the information
@@ -146,6 +147,7 @@ def find_kit_filename(fallback_directory: Optional[str] = None) -> Optional[str]
     return None
 
 
+# Deprecated
 def launch_kit_instance(
     kit_path: Optional[str] = None,
     extension_paths: Optional[List[str]] = None,
@@ -210,6 +212,99 @@ def launch_kit_instance(
     return OmniverseKitInstance(p.pid)
 
 
+def find_app() -> Optional[str]:
+    dirs_to_check = []
+    if "PYENSIGHT_ANSYS_INSTALLATION" in os.environ:
+        env_inst = os.environ["PYENSIGHT_ANSYS_INSTALLATION"]
+        dirs_to_check.append(os.path.join(env_inst, "tp", "omni_viewer"))
+
+    # Look for most recent Ansys install, 25.2 or later
+    awp_roots = []
+    for env_name in dict(os.environ).keys():
+        if env_name.startswith("AWP_ROOT") and int(env_name[len("AWP_ROOT") :]) >= 252:
+            awp_roots.append(env_name)
+    awp_roots.sort(reverse=True)
+    for env_name in awp_roots:
+        dirs_to_check.append(os.path.join(os.environ[env_name], "tp", "omni_viewer"))
+
+    # check all the collected locations in order
+    for install_dir in dirs_to_check:
+        launch_file = os.path.join(install_dir, "ansys_tools_omni_core.py")
+        if os.path.isfile(launch_file):
+            return launch_file
+    return None
+
+
+def launch_app(
+    usd_file: Optional[str] = "",
+    layout: Optional[str] = "default",
+    streaming: Optional[bool] = False,
+    offscreen: Optional[bool] = False,
+    log_file: Optional[str] = None,
+    log_level: Optional[str] = "warn",
+    cli_options: Optional[List[str]] = None,
+) -> "OmniverseKitInstance":
+    """Launch the Ansys Omniverse application
+
+    Parameters
+    ----------
+    # usd_file : Optional[str]
+    #    A .usd file to open on startup
+    # layout : Optional[str]
+    #    A UI layout.  viewer, composer, or composer_slim
+    # streaming : Optional[bool]
+    #    Enable webrtc streaming to enable the window in a web page
+    # offscreen : Optional[str]
+    #    Run the app offscreen.  Useful when streaming.
+    # log_file : Optional[str]
+    #    The name of a text file where the logging information for the instance will be saved.
+    # log_level : Optional[str]
+    #    The level of the logging information to record: "verbose", "info", "warn", "error", "fatal",
+    #    the default is "warn".
+    # cli_options : Optional[List[str]]
+    #    Other command line options
+
+    Returns
+    -------
+    OmniverseKitInstance
+        The object interface for the launched instance
+
+    Examples
+    --------
+    Run the app with default options
+
+    >>> from ansys.pyensight.core.utils import omniverse
+    >>> ov = omniverse.launch_app()
+
+    """
+    cmd = [sys.executable]
+    app = find_app()
+    if not app:
+        raise RuntimeError("Unable to find the Ansys Omniverse app")
+    cmd.extend([app])
+    if usd_file:
+        cmd.extend(["-f", usd_file])
+    if layout:
+        cmd.extend(["-l", layout])
+    if streaming:
+        cmd.extend(["-s"])
+    if offscreen:
+        cmd.extend(["-o"])
+    if cli_options:
+        cmd.extend(cli_options)
+    if log_level:
+        if log_level not in ("verbose", "info", "warn", "error", "fatal"):
+            raise RuntimeError(f"Invalid logging level: {log_level}")
+        cmd.extend([f"--/log/level={log_level}"])
+    if log_file:
+        cmd.extend(["--/log/enabled=true", f"--/log/file={log_file}"])
+
+    # Launch the process
+    env_vars = os.environ.copy()
+    p = subprocess.Popen(cmd, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL, env=env_vars)
+    return OmniverseKitInstance(p.pid)
+
+
 class Omniverse:
     """Provides the ``ensight.utils.omniverse`` interface.
 

ansys/pyensight/core/utils/omniverse_dsg_server.py

@@ -26,6 +26,7 @@
 import logging
 import math
 import os
+import platform
 import shutil
 import sys
 import tempfile
@@ -42,6 +43,10 @@ except ModuleNotFoundError:
     if sys.version_info.minor >= 13:
         warnings.warn("USD Export not supported for Python >= 3.13")
         sys.exit(1)
+    is_linux_arm64 = platform.system() == "Linux" and platform.machine() == "aarch64"
+    if is_linux_arm64:
+        warnings.warn("USD Export not supported on Linux ARM platforms")
+        sys.exit(1)
 
 
 class OmniverseWrapper(object):

{ansys_pyensight_core-0.10.2.dist-info → ansys_pyensight_core-0.10.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ansys-pyensight-core
-Version: 0.10.2
+Version: 0.10.3
 Summary: A python wrapper for Ansys EnSight
 Author-email: "ANSYS, Inc." <pyansys.core@ansys.com>
 Maintainer-email: "ANSYS, Inc." <pyansys.core@ansys.com>
@@ -25,7 +25,7 @@ Requires-Dist: numpy>=1.21.0,<3
 Requires-Dist: Pillow>=9.3.0
 Requires-Dist: pypng>=0.0.20
 Requires-Dist: psutil>=5.9.2
-Requires-Dist: usd-core==24.8; python_version < '3.13'
+Requires-Dist: usd-core==24.8; python_version < '3.13' and platform_machine != 'aarch64'
 Requires-Dist: pygltflib>=1.16.2
 Requires-Dist: build>=0.10.0 ; extra == "dev"
 Requires-Dist: bump2version>=1.0.1 ; extra == "dev"

{ansys_pyensight_core-0.10.2.dist-info → ansys_pyensight_core-0.10.3.dist-info}/RECORD

@@ -9,20 +9,20 @@ ansys/pyensight/core/ensight_grpc.py,sha256=IitEgMzBJTyTgQff0sXPvGkVnC2E9qRKw-HX
 ansys/pyensight/core/ensobj.py,sha256=uDtM2KHcAwd4hu5pcUYWbSD729ApHGIvuqZhEq8PxTI,18558
 ansys/pyensight/core/launch_ensight.py,sha256=iZJM6GdpzGRDLzrv1V2QZ5veIOpNSB5xPpJUFY7rBuo,10254
 ansys/pyensight/core/launcher.py,sha256=x6L1E6OGpqL2jrDdIGI0p4BxQZhHt93yl1Pwj_2lAiQ,13143
-ansys/pyensight/core/libuserd.py,sha256=YKXY1aaaTBT2uwcyhPEW-f93KLtCYQNMJXTlBsenWDI,75459
+ansys/pyensight/core/libuserd.py,sha256=er49fOZJ050OU122cYQgtdDSFr2YNNvKoqFk7Ogjiro,76018
 ansys/pyensight/core/listobj.py,sha256=Trw87IxIMXtmUd1DzywRmMzORU704AG4scX4fqYmO6M,9340
 ansys/pyensight/core/locallauncher.py,sha256=1zrBK2NTdodMaKYI2588a8HR7_SqMVmoUW7ItqwxMEI,17039
 ansys/pyensight/core/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ansys/pyensight/core/renderable.py,sha256=KidVTVCZ4hKYq54pP9KoJ8OCxeWBXNUJYyKSwMZ2Sls,36362
-ansys/pyensight/core/session.py,sha256=6UEMn6X_08JzaAhmpIi4TQfv8zdONDG1cH8UaO7MQR8,74114
+ansys/pyensight/core/session.py,sha256=nNYKzbmVRELUHtj0XRU80JNiAVcuXsOeXXh3CbJLsLA,74450
 ansys/pyensight/core/sgeo_poll.html,sha256=1M4BIc5CZpYA3b40qzk22NcPCLhjFnWdoS2PrS6Rhn4,752
 ansys/pyensight/core/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ansys/pyensight/core/utils/adr.py,sha256=XslZhlwcrSGzOlnhzprOv3ju_ppxxsWBjCnQL5KiNms,3570
 ansys/pyensight/core/utils/dsg_server.py,sha256=2jCPhOplPrlDaQNSKSk9qo7bEgfcrhx0rHS_cqW2zAY,47003
 ansys/pyensight/core/utils/export.py,sha256=UAJQcrElo3esQD0CWdxxjMQ8yE1vB4cdAhF33_uZfQw,22605
-ansys/pyensight/core/utils/omniverse.py,sha256=qeIA9WgHHsf-fylT5I3z7rBUZUlSEOR-fLTvqgCPqbQ,18996
+ansys/pyensight/core/utils/omniverse.py,sha256=j8yB5776Nd42skVZSARRx-zJxODUODhdYgg8OryADlc,22208
 ansys/pyensight/core/utils/omniverse_cli.py,sha256=ujoBbBGMYsYUn83nrk2dFkOd7kn7-6cs7ljBmmSXodw,20578
-ansys/pyensight/core/utils/omniverse_dsg_server.py,sha256=-62_pDAJ0UlFnjf91Ra4W63musyJxdBON1L66bve7ns,40186
+ansys/pyensight/core/utils/omniverse_dsg_server.py,sha256=pyZTZ63xMUmjR5PQNp5M-ab0iofLveCo3WR3f7Ibgus,40404
 ansys/pyensight/core/utils/omniverse_glb_server.py,sha256=dx2cfR036d3DY6meooNfLZOQpOMaiaLKqBjztpew2_Q,32167
 ansys/pyensight/core/utils/parts.py,sha256=222XFRCjLgH7hho-cK9JrGCg3-KlTf54KIgc7y50sTE,52173
 ansys/pyensight/core/utils/query.py,sha256=OXKDbf1sOTX0sUvtKcp64LhVl-BcrEsE43w8uMxLOYI,19828
@@ -31,7 +31,7 @@ ansys/pyensight/core/utils/support.py,sha256=QI3z9ex7zJxjFbkCPba9DWqWgPFIThORqr0
 ansys/pyensight/core/utils/variables.py,sha256=ZUiJdDIeRcowrnLXaJQqGwA0RbrfXhc1s4o4v9A4PiY,95133
 ansys/pyensight/core/utils/views.py,sha256=ZKhJ6vMT7Rdd4bwJ0egMYTV7-D7Q7I19fF2_j_CMQ0o,12489
 ansys/pyensight/core/utils/resources/Materials/000_sky.exr,sha256=xAR1gFd2uxPZDnvgfegdhEhRaqKtZldQDiR_-1rHKO0,8819933
-ansys_pyensight_core-0.10.2.dist-info/licenses/LICENSE,sha256=K6LiJHOa9IbWFelXmXNRzFr3zG45SOGZIN7vdLdURGU,1097
-ansys_pyensight_core-0.10.2.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
-ansys_pyensight_core-0.10.2.dist-info/METADATA,sha256=rkwABz7C5a1cXJQolvlyIOMAyHD96ZWk8pbbWUDJ62c,12169
-ansys_pyensight_core-0.10.2.dist-info/RECORD,,
+ansys_pyensight_core-0.10.3.dist-info/licenses/LICENSE,sha256=K6LiJHOa9IbWFelXmXNRzFr3zG45SOGZIN7vdLdURGU,1097
+ansys_pyensight_core-0.10.3.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
+ansys_pyensight_core-0.10.3.dist-info/METADATA,sha256=mN7adXDQiyjNjDdBdybX_yZDHlUDkP0iewgw3ucHmWY,12203
+ansys_pyensight_core-0.10.3.dist-info/RECORD,,