sxs 2025.0.14__py3-none-any.whl → 2025.0.16__py3-none-any.whl

sxs/__version__.py

@@ -1 +1 @@
-__version__ = "2025.0.14"
+__version__ = "2025.0.16"

sxs/citation.py

@@ -30,6 +30,9 @@ def cite(*sxs_ids, bibtex=True):
     from . import doi_prefix, load, __version__
     from . import sxs_id as sxs_identifier
 
+    if len(sxs_ids) == 1 and isinstance(sxs_ids[0], (list, tuple)):
+        sxs_ids = tuple(sxs_ids[0])
+
     simulations = load("simulations")
 
     # Get the DOI for this version of this package

sxs/handlers.py

@@ -199,29 +199,36 @@ def load(location, download=None, cache=None, progress=None, truepath=None, **kw
     -----
     This function can load data in various ways.
 
-      1) Given an absolute or relative path to a local file, it just
-         loads the data directly.
-
-      2) If `truepath` is set, and points to a file that exists —
+      1) If `truepath` is set, and points to a file that exists —
          whether absolute, relative to the current working directory,
          or relative to the cache directory — that file will be
          loaded.
 
-      3) If `location` is a valid URL including the scheme (https://,
+      2) Given an absolute or relative path to a local file, it just
+         loads the data directly.
+
+      3) If `location` is one of "simulations" or "dataframe" (or the
+         deprecated "catalog"), the corresponding catalog data is
+         loaded.  The "simulations" option returns a dictionary mapping
+         SXS IDs to raw metadata, while "dataframe" returns a pandas
+         DataFrame indexed by SXS ID, but the metadata is processed
+         into more consistent form.
+
+      4) If `location` is a valid URL including the scheme (https://,
          or http://), it will be downloaded regardless of the
          `download` parameter and optionally cached.
 
-      4) Given an SXS simulation specification — like "SXS:BBH:1234",
+      5) Given an SXS simulation specification — like "SXS:BBH:1234",
          "SXS:BBH:1234v2.0", "SXS:BBH:1234/Lev5", or
          "SXS:BBH:1234v2.0/Lev5" — the simulation is loaded as an
          `sxs.Simulation` object.
 
-      5) Given an SXS path — like
+      6) Given an SXS path — like
          "SXS:BBH:1234/Lev5/h_Extrapolated_N2.h5" — the file is
          located in the catalog for details.  This function then looks
          in the local cache directory and loads it if present.
 
-      6) If the SXS path is not found in the cache directory and
+      7) If the SXS path is not found in the cache directory and
          `download` is set to `True` (when this function is called, or
          in the sxs config file) this function attempts to download
          the data.  Note that `download` must be explicitly set in
@@ -263,6 +270,15 @@ def load(location, download=None, cache=None, progress=None, truepath=None, **kw
         elif truepath and (testpath := cache_path / sxs_path_to_system_path(truepath)).exists():
             path = testpath
 
+        elif _safe_resolve_exists(path):
+            pass  # We already have the correct path
+
+        elif location == "catalog":
+            return Catalog.load(download=download)
+
+        elif location in ["simulations", "dataframe"]:
+            return sxscatalog.load(location, download=download, **kwargs)
+
         elif _safe_resolve_exists(h5_path):
             path = h5_path
 
@@ -278,12 +294,6 @@ def load(location, download=None, cache=None, progress=None, truepath=None, **kw
                     raise ValueError(f"File '{truepath}' not found in cache, but downloading turned off")
                 download_file(location, path, progress=progress)
 
-        elif location == "catalog":
-            return Catalog.load(download=download)
-
-        elif location in ["simulations", "dataframe"]:
-            return sxscatalog.load(location, download=download, **kwargs)
-
         elif sxs_id_version_lev_exact_re.match(location):
             return Simulation(location, download=download, cache=cache, progress=progress, **kwargs)
 

{sxs-2025.0.14.dist-info → sxs-2025.0.16.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sxs
-Version: 2025.0.14
+Version: 2025.0.16
 Summary: Interface to data produced by the Simulating eXtreme Spacetimes collaboration
 Project-URL: Homepage, https://github.com/sxs-collaboration/sxs
 Project-URL: Documentation, https://sxs.readthedocs.io/

{sxs-2025.0.14.dist-info → sxs-2025.0.16.dist-info}/RECORD

@@ -1,7 +1,7 @@
 sxs/__init__.py,sha256=C8VhmrUPAa70Y-C2KfZv9BhS6ef-eB7uaNtwm18IRhk,2637
-sxs/__version__.py,sha256=eCKOuEJ8I4r8khfPMQo8e9Eo2SpoVADBudzBmD192cs,26
-sxs/citation.py,sha256=90c8zOsWTcDX42NWEKGPLWvDYVORj2Ie9VPKZti-iOU,7062
-sxs/handlers.py,sha256=jVV-HK-omzoBx5N2wcpLHvyoWq86hUfWCjnGbPpD91I,18343
+sxs/__version__.py,sha256=xCVYVWrP49sS05Knu6LBHhTBlrCM-7hIvBCvunxySHA,26
+sxs/citation.py,sha256=QAiRnasTXpufZCaoxTKR5ESSJQ2ww7FgWyxoaaAQifw,7167
+sxs/handlers.py,sha256=rUS0TmbewpllnZHkS5TXCx6nxGA-E8xrBGLlejBPEAg,18820
 sxs/juliapkg.json,sha256=-baaa3Za_KBmmiGjlh2YYLWmvUvZl6GaKKXwNI4S7qU,178
 sxs/time_series.py,sha256=OKaLg8tFyrtKcef7900ri-a0C6A8wKxA68KovZXvH6I,41081
 sxs/catalog/__init__.py,sha256=9-WTMTPDmqqkFyIHOtEbPA6etXm3_RSRrLWvHtLrjLg,205
@@ -83,7 +83,7 @@ sxs/zenodo/api/__init__.py,sha256=EM_eh4Q8R5E0vIfMhyIR1IYFfOBu6vA0UTasgX9gHys,21
 sxs/zenodo/api/deposit.py,sha256=J4RGvGjh0cEOrN4bBZWEDcPAhNscqB2fzLlvRZ5HTHM,36948
 sxs/zenodo/api/login.py,sha256=hXyxLrx1PALaEEH76XrBvlO5Wwz-qa-MCjkI8UyB3t0,18005
 sxs/zenodo/api/records.py,sha256=nKkhoHZ95CTztHF9Zzaug5p7IiUCJG4Em1i-l-WqH6U,3689
-sxs-2025.0.14.dist-info/METADATA,sha256=zCZwHwSN4HulK5BOz-UAqjMuPqrChhMmjw5f5wYnMig,12857
-sxs-2025.0.14.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-sxs-2025.0.14.dist-info/licenses/LICENSE,sha256=ptVOd5m7LDM5ZF0x32cxb8c2Nd5NDmAhy6DX7xt_7VA,1080
-sxs-2025.0.14.dist-info/RECORD,,
+sxs-2025.0.16.dist-info/METADATA,sha256=A-DbdcADvHCuL5mIbKoA2NU3FDv_xaF3qU1yewLPiXs,12857
+sxs-2025.0.16.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+sxs-2025.0.16.dist-info/licenses/LICENSE,sha256=ptVOd5m7LDM5ZF0x32cxb8c2Nd5NDmAhy6DX7xt_7VA,1080
+sxs-2025.0.16.dist-info/RECORD,,