lamindb 0.73.2__py3-none-any.whl → 0.74.1__py3-none-any.whl

lamindb/core/_settings.py

@@ -9,11 +9,13 @@ from lamindb_setup._set_managed_storage import set_managed_storage
 from lamindb_setup.core._settings import settings as setup_settings
 from lamindb_setup.core._settings_instance import sanitize_git_repo_url
 
-from ._transform_settings import TransformSettings, transform
+from .subsettings._creation_settings import CreationSettings, creation_settings
+from .subsettings._transform_settings import TransformSettings, transform_settings
 
 if TYPE_CHECKING:
     from pathlib import Path
 
+    from lamindb_setup.core._settings_storage import StorageSettings
     from upath import UPath
 
 VERBOSITY_TO_INT = {
@@ -40,29 +42,15 @@ class Settings:
         logger.set_verbosity(self._verbosity_int)
         self._sync_git_repo: str | None = git_repo
 
-    upon_artifact_create_if_hash_exists: Literal[
-        "warn_return_existing", "error", "warn_create_new"
-    ] = "warn_return_existing"
-    """Behavior if file hash exists (default `"warn_return_existing"`).
-
-    One of `["warn_return_existing", "error", "warn_create_new"]`.
-
-    FAQ: :doc:`/faq/idempotency`
-    """
-    upon_file_create_skip_size_hash: bool = False
-    """To speed up registering high numbers of files (default `False`).
-
-    This bypasses queries for size and hash to AWS & GCP.
-
-    It speeds up file creation by about a factor 100.
-    """
-    upon_create_search_names: bool = True
-    """To speed up creating Registry objects (default `True`).
+    @property
+    def creation(self) -> CreationSettings:
+        """Record creation settings.
 
-    If `True`, search for alternative names.
+        For example, `ln.settings.creation.search_names = False` will disable
+        searching for records with similar names during creation.
+        """
+        return creation_settings
 
-    FAQ: :doc:`/faq/idempotency`
-    """
     track_run_inputs: bool = True
     """Track files as input upon `.load()`, `.cache()` and `.backed()`.
 
@@ -70,14 +58,6 @@ class Settings:
 
     FAQ: :doc:`/faq/track-run-inputs`
     """
-    silence_file_run_transform_warning: bool = False
-    """Silence warning about missing run & transform during file creation."""
-    artifact_use_virtual_keys: bool = True
-    """Treat `key` parameter in :class:`~lamindb.Artifact` as virtual.
-
-    If `True`, the `key` is **not** used to construct file paths, but file paths are
-    based on the `uid` of artifact.
-    """
     __using_key: str | None = None
     _using_storage: str | None = None
 
@@ -101,8 +81,17 @@ class Settings:
 
     @property
     def transform(self) -> TransformSettings:
-        """Transform settings."""
-        return transform
+        """Transform settings.
+
+        For example::
+
+            ln.settings.transform.stem_uid = "FPnfDtJz8qbE"  # defines version family
+            ln.settings.transform.version = "1"              # defines version
+            ln.settings.transform.name = "My good script"    # semantic name
+
+        The first two are typically auto-generated by :func:`~lamindb.track`.
+        """
+        return transform_settings
 
     @property
     def sync_git_repo(self) -> str | None:
@@ -116,18 +105,25 @@ class Settings:
     def sync_git_repo(self, value) -> None:
         """Sync transforms with scripts in git repository.
 
-        Provide the full git repo URL.
+        For example: `ln.sync_git_repo = https://github.com/laminlabs/redun-lamin`
         """
         self._sync_git_repo = sanitize_git_repo_url(value)
         assert self._sync_git_repo.startswith("https://")
 
     @property
-    def storage(self) -> Path | UPath:
-        """Default storage location (a path to its root).
+    def storage(self) -> StorageSettings:
+        """Default storage location.
 
         Examples:
 
-        You can switch to another managed storage location via:
+        >>> ln.settings.storage
+        StorageSettings(root='s3://my-bucket', uid='j7MaPxtLxPeE')
+
+        >>> ln.settings.storage.root
+        UPath('s3://my-bucket')
+
+        You can switch the default storage location to another managed storage
+        location by passing a string:
 
         >>> ln.settings.storage = "s3://some-bucket"
 
@@ -139,7 +135,7 @@ class Settings:
         >>> )
         >>> ln.settings.storage = "s3://some-bucket", kwargs
         """
-        return self._storage_settings.root
+        return self._storage_settings
 
     @storage.setter
     def storage(self, path_kwargs: str | Path | UPath | tuple[str | UPath, Mapping]):
@@ -150,16 +146,14 @@ class Settings:
         set_managed_storage(path, **kwargs)
 
     @property
-    def storage_local(self) -> Path:
+    def storage_local(self) -> StorageSettings:
         """An additional local default storage (a path to its root).
 
         Is only available if :attr:`~lamindb.setup.core.InstanceSettings.keep_artifacts_local` is enabled.
 
         Guide: :doc:`faq/keep-artifacts-local`
-
-        Shortcut for: `ln.setup.settings.instance.storage_local.root`
         """
-        return ln_setup.settings.instance.storage_local.root
+        return ln_setup.settings.instance.storage_local
 
     @storage_local.setter
     def storage_local(self, local_root: Path):
@@ -167,14 +161,14 @@ class Settings:
 
     @property
     def verbosity(self) -> str:
-        """Logger verbosity (default 'warning').
-
-        - 'error': ❌ only show error messages
-        - 'warning': ❗ also show warning messages
-        - 'success': ✅ also show success and save messages
-        - 'info': 💡 also show info messages
-        - 'hint': 💡 also show hint messages
-        - 'debug': 🐛 also show detailed debug messages
+        """Logger verbosity (default `'warning'`).
+
+        - `'error'`: ❌ only show error messages
+        - `'warning'`: ❗ also show warning messages
+        - `'success'`: ✅ also show success and save messages
+        - `'info'`: 💡 also show info messages
+        - `'hint'`: 💡 also show hint messages
+        - `'debug'`: 🐛 also show detailed debug messages
         """
         return VERBOSITY_TO_STR[self._verbosity_int]
 

lamindb/core/datasets/_core.py

@@ -91,7 +91,7 @@ def file_tsv_rnaseq_nfcore_salmon_merged_gene_counts(
 
 def file_fastq(in_storage_root=False) -> Path:
     """Mini mock fastq artifact."""
-    basedir = Path() if not in_storage_root else settings.storage
+    basedir = Path() if not in_storage_root else settings.storage.root
     filepath = basedir / "input.fastq.gz"
     with open(filepath, "w") as f:
         f.write("Mock fastq artifact.")
@@ -100,7 +100,7 @@ def file_fastq(in_storage_root=False) -> Path:
 
 def file_bam(in_storage_root=False) -> Path:  # pragma: no cover
     """Mini mock bam artifact."""
-    basedir = Path() if not in_storage_root else settings.storage
+    basedir = Path() if not in_storage_root else settings.storage.root
     filepath = basedir / "output.bam"
     with open(filepath, "w") as f:
         f.write("Mock bam artifact.")
@@ -109,7 +109,7 @@ def file_bam(in_storage_root=False) -> Path:  # pragma: no cover
 
 def file_mini_csv(in_storage_root=False) -> Path:
     """Mini csv artifact."""
-    basedir = Path() if not in_storage_root else settings.storage
+    basedir = Path() if not in_storage_root else settings.storage.root
     filepath = basedir / "mini.csv"
     df = pd.DataFrame([1, 2, 3], columns=["test"])
     df.to_csv(filepath, index=False)

lamindb/core/storage/paths.py

@@ -72,7 +72,7 @@ def attempt_accessing_path(
             storage_settings = settings._storage_settings
         else:
             storage_settings = StorageSettings(
-                settings.storage, access_token=access_token
+                settings.storage.root, access_token=access_token
             )
     else:
         if artifact._state.db not in ("default", None) and using_key is None:
@@ -143,8 +143,8 @@ def delete_storage(
     """Delete arbitrary artifact."""
     # TODO is_relative_to is not available in 3.8 and deprecated since 3.12
     # replace with check_path_is_child_of_root but this needs to first be debugged
-    # if not check_path_is_child_of_root(storagepath, settings.storage):
-    if not storagepath.is_relative_to(settings.storage):  # type: ignore
+    # if not check_path_is_child_of_root(storagepath, settings.storage.root):
+    if not storagepath.is_relative_to(settings.storage.root):  # type: ignore
         allow_delete = False
         if setup_settings.instance.keep_artifacts_local:
             allow_delete = storagepath.is_relative_to(  # type: ignore

lamindb/core/subsettings/__init__.py

@@ -0,0 +1,12 @@
+"""Sub settings.
+
+.. autosummary::
+   :toctree: .
+
+   TransformSettings
+   CreationSettings
+
+"""
+
+from ._creation_settings import CreationSettings
+from ._transform_settings import TransformSettings

lamindb/core/subsettings/_creation_settings.py

@@ -0,0 +1,38 @@
+from typing import Literal
+
+
+class CreationSettings:
+    artifact_if_hash_exists: Literal[
+        "warn_return_existing", "error", "warn_create_new"
+    ] = "warn_return_existing"
+    """Behavior if file hash exists (default `"warn_return_existing"`).
+
+    One of `["warn_return_existing", "error", "warn_create_new"]`.
+
+    FAQ: :doc:`/faq/idempotency`
+    """
+    artifact_skip_size_hash: bool = False
+    """To speed up registering high numbers of files (default `False`).
+
+    This bypasses queries for size and hash to AWS & GCP.
+
+    It speeds up file creation by about a factor 100.
+    """
+    search_names: bool = True
+    """To speed up creating records (default `True`).
+
+    If `True`, search for alternative names.
+
+    FAQ: :doc:`/faq/idempotency`
+    """
+    artifact_silence_missing_run_warning: bool = False
+    """Silence warning about missing run & transform during artifact creation."""
+    _artifact_use_virtual_keys: bool = True
+    """Treat `key` parameter in :class:`~lamindb.Artifact` as virtual.
+
+    If `True`, the `key` is **not** used to construct file paths, but file paths are
+    based on the `uid` of artifact.
+    """
+
+
+creation_settings = CreationSettings()

lamindb/core/subsettings/_transform_settings.py

@@ -0,0 +1,21 @@
+from __future__ import annotations
+
+
+class TransformSettings:
+    stem_uid: str | None = None
+    """Defines the version family of the transform.
+
+    For example, all notebooks of the same family have a uid that starts with
+    `"FPnfDtJz8qbE"`.
+
+    The full uids of the notebooks in this family are of form
+    `"{stem_uid}{suffix_uid}"` where the `suffix_uid` encodes the semantic
+    `version`.
+    """
+    version: str | None = None
+    """The version."""
+    name: str | None = None
+    """A name like a notebook or script title."""
+
+
+transform_settings = TransformSettings()

{lamindb-0.73.2.dist-info → lamindb-0.74.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: lamindb
-Version: 0.73.2
+Version: 0.74.1
 Summary: A data framework for biology.
 Author-email: Lamin Labs <open-source@lamin.ai>
 Requires-Python: >=3.8
@@ -9,15 +9,15 @@ Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
-Requires-Dist: lnschema_core==0.69.0
-Requires-Dist: lamindb_setup==0.73.1
+Requires-Dist: lnschema_core==0.70.0
+Requires-Dist: lamindb_setup==0.73.2
 Requires-Dist: lamin_utils==0.13.2
 Requires-Dist: lamin_cli==0.14.0
 Requires-Dist: rapidfuzz
 Requires-Dist: pyarrow
 Requires-Dist: typing_extensions!=4.6.0
 Requires-Dist: python-dateutil
-Requires-Dist: anndata>=0.8.0,<0.10.8
+Requires-Dist: anndata>=0.8.0,<=0.10.8
 Requires-Dist: scipy<1.13.0rc1
 Requires-Dist: fsspec
 Requires-Dist: pandas
@@ -59,7 +59,7 @@ Provides-Extra: zarr
 
 # LaminDB - A data framework for biology
 
-- Manage storage & databases with a unified Python API ("lakehouse").
+- Manage data & metadata with a unified Python API ("lakehouse").
 - Track data lineage across notebooks & pipelines.
 - Integrate registries for experimental metadata & in-house ontologies.
 - Validate, standardize & annotate.

{lamindb-0.73.2.dist-info → lamindb-0.74.1.dist-info}/RECORD

@@ -1,42 +1,41 @@
-lamindb/__init__.py,sha256=ewJ0w3ggVARCnYyCLLJ_24n2eQDgjK3TXkzjyBn67sE,2207
+lamindb/__init__.py,sha256=7wGOqqM6NyKeQG6qqir53qzUowWMRAd36tH5L874hd0,2182
 lamindb/_annotate.py,sha256=CScyKVB3k_x5p0pihxO1UrTFBCvPcSSjBXvGY3YgTLs,44381
-lamindb/_artifact.py,sha256=uMUlXCGU1JYSnOYMxCwEe_1MslbcnZACP9SYL-a4zRk,40816
+lamindb/_artifact.py,sha256=zVNBF7y-rARGG78Z2d2dI2J0Tg_5yeZL-GfogzBB7xY,40456
 lamindb/_can_validate.py,sha256=s1q0lxplqnhytrVgArBTm05XKMMmpreK0ZlVCsd2jjk,14849
 lamindb/_collection.py,sha256=AGiztgM_OIet617aF86muL6lIv6GEDcmXorize6V62U,14657
-lamindb/_feature.py,sha256=Aawz4jCgjhuneZnmoty7JkZI3zjA_50vr_0dnFjSN3U,7348
+lamindb/_feature.py,sha256=Z_Awtsj183SA1egZgNmJI_dH04rqXAj72od3H6n0uBk,7398
 lamindb/_feature_set.py,sha256=ZAFLyIiWC6yPOFTF7K03olE2Rl3KthsV-1ttqJySzqQ,8106
 lamindb/_filter.py,sha256=jEA1n1Hi6lEPaD0JXiTSh9K4joGzWU6Yxy0LCLTiOdY,1422
-lamindb/_finish.py,sha256=CP52X5Wr-96DdXVGqz_Ls4uum3OErk1Twt9e74Q4grk,9945
-lamindb/_from_values.py,sha256=qQTeIjA8RrW5Dpv6ZdzTeLU3WS1NEsftP0igesLJUqw,13649
+lamindb/_finish.py,sha256=WkFvZ0DijW9fRIsjyoxcAC4ehan_B0C8Fqoz9ZON19A,10213
+lamindb/_from_values.py,sha256=Sq1NdjsqReih8aUR-JHZ09pxHdqL8rY-cZFHo078OJw,13886
 lamindb/_is_versioned.py,sha256=0PgRCmxEmYDcAjllLSOYZm132B1lW6QgmBBERhRyFt0,1341
 lamindb/_parents.py,sha256=kb5AHkntpTP5g2lk1aPL0FmIilYZYVZvj6stddFOI40,15075
-lamindb/_query_manager.py,sha256=qxwrBM8UmNQnUiNOfe84YN6NpfJBg2wQ2JqUfH6HHhc,4225
-lamindb/_query_set.py,sha256=JgdJY2pACCqjC4AHjFiMAdq_qjeuhEo2NUX68f6ODwk,11597
-lamindb/_registry.py,sha256=hoBkVl8D4yLQKMoOhVIDTNkO_401yCoVHI4MlNHDZgI,18756
-lamindb/_run.py,sha256=b7A52M1On3QzFgIYyfQoz5Kk7V3wcu9p_Prq5bzd8v8,1838
+lamindb/_query_manager.py,sha256=TjiwtX5CErEV58WyUFJ76p0riuPDODf8LGXo48aR9Fg,4236
+lamindb/_query_set.py,sha256=q3C0gdfassidngMteGHuOlhHmt_3VXEGOwblRDInxpA,11626
+lamindb/_registry.py,sha256=C_QKBAOhFj_pROBLUlieiPYWljd5ThPpTXunAekCQe8,18764
+lamindb/_run.py,sha256=xj3ER4F_yWvuNw1mr0XU-QuIPi5hBO7Ue0ygBgJQ6mc,1887
 lamindb/_save.py,sha256=It4XO448D8NG2cReo9Xy0lQBQdkMm_rCx_TGD1qZWWc,11864
-lamindb/_storage.py,sha256=VW8xq3VRv58-ciholvOdlcgvp_OIlLxx5GxLt-e2Irs,614
+lamindb/_storage.py,sha256=8wRefV-Klu6VBVtwcwppvTojeXnxRThaBdFniA0AEIw,400
 lamindb/_transform.py,sha256=E9C7psuOnsNrUQpWRuGgEUM8_pc7YhDn7n4ieHzB4X0,3169
 lamindb/_ulabel.py,sha256=XDSdZBXX_ki5s1vOths3MjF2x5DPggBR_PV_KF4SGyg,1611
 lamindb/_utils.py,sha256=LGdiW4k3GClLz65vKAVRkL6Tw-Gkx9DWAdez1jyA5bE,428
 lamindb/_view.py,sha256=NdWWF75rmkCHefqBViUnsHLu3OViJ1z_bEvfcedydsw,2330
-lamindb/core/__init__.py,sha256=RkE5BrdOWNHQIz60z1npYoRim-Ot24-L7JTmLXd2WTU,1363
-lamindb/core/_data.py,sha256=xkjEvAhWeEEYRIZIi9Qbb0aEWiUPttq-qnCLx_2xy48,16172
-lamindb/core/_feature_manager.py,sha256=h7puH83LjaiJrBlmw3wSkUVO5c_LVfubCJKklPryP84,26205
+lamindb/core/__init__.py,sha256=RDtvov8NkPTNT4Lhs1KWTd2s4eQsPBH0s3fQRNJQCZA,1375
+lamindb/core/_data.py,sha256=u6eYlDOnLuwFMRsyg97qoIushwbHhwoQT-zjEL7p8VU,16241
+lamindb/core/_feature_manager.py,sha256=OQ14OONCRecqVatNm5kALh5LuhWqKrwoMNPJ_qHtGhw,31372
 lamindb/core/_label_manager.py,sha256=d9r3tiNDFbpZQmxE1jmgdgnMYPOfTPpAKGKtRRLmVj8,9640
 lamindb/core/_mapped_collection.py,sha256=_OwFZh5SePDUD70XIK5kngv3we_Z5-YdGHNfpUSatSQ,19469
-lamindb/core/_run_context.py,sha256=aGdZv4IeYo7QpXl9H9U7RNwpgzqGeCDKPuoSdtP-CAE,18988
-lamindb/core/_settings.py,sha256=rW1KfEXfT56XErwcnSuQxaCytpOy1kJ-u7tVmkmNmxY,6131
+lamindb/core/_run_context.py,sha256=ybGgrzGBy9kOyQNH1bPaMixXZNmZGynAP1eO6Zwtp4A,18393
+lamindb/core/_settings.py,sha256=HIuCC9xEVo_3o-uogZlN-6oQVs92EWmaqBJWAdGKj5o,6009
 lamindb/core/_sync_git.py,sha256=5Fb82eG1WYyBlfMRCMlcUZNTVk70UU_SPnfvYEBL-A8,4124
 lamindb/core/_track_environment.py,sha256=xLZ6kgzxWS6MWZ5LQ_wkbJX99vmYOT8iQ-Fz4OHCgWw,754
-lamindb/core/_transform_settings.py,sha256=eV96QKX9jOojjzF-a0oo0wXQsMXN2F6QV7orE06oFC8,161
 lamindb/core/exceptions.py,sha256=bbm-PeSy24qFcqh2HpucZWpwGAvk-TL_3FUoAPb3e3E,867
 lamindb/core/fields.py,sha256=Jgi_XI-iTe6cT7oD8FV_JqEpjN1Q9rZWwL8VLtj4jkA,164
 lamindb/core/schema.py,sha256=BbG7JGrXVLwEX_6eQb8ouJc9Q-MgazwqHvAM5dtrWtM,1861
 lamindb/core/types.py,sha256=xeQF2x40p2pR9eIVQrXT74RrS810z2fbjmTRTSQUqPM,230
 lamindb/core/versioning.py,sha256=zbp3wAWOqU1uDF9wRrpaS9JfmRglUQtVHvFpWWoJHZk,4943
 lamindb/core/datasets/__init__.py,sha256=zRP98oqUAaXhqWyKMiH0s_ImVIuNeziQQ2kQ_t0f-DI,1353
-lamindb/core/datasets/_core.py,sha256=bMNtx2tXhzvjLkHmg9I5jE1xMTxPH68hovnX6_NjT6g,19858
+lamindb/core/datasets/_core.py,sha256=11vsIRREU7TvjwkL2htJWAGoBNCmG2qz8ps4Bd4SNLQ,19873
 lamindb/core/datasets/_fake.py,sha256=BZF9R_1iF0HDnvtZNqL2FtsjSMuqDIfuFxnw_LJYIh4,953
 lamindb/core/storage/__init__.py,sha256=5LUFQKRr2BX24d-yWBezhTXBV83sShcOvPj5Y5u6qIg,441
 lamindb/core/storage/_anndata_sizes.py,sha256=aXO3OB--tF5MChenSsigW6Q-RuE8YJJOUTVukkLrv9A,1029
@@ -44,12 +43,15 @@ lamindb/core/storage/_backed_access.py,sha256=eManrLsu3pSSQAyAKy47FDBm-iHgjaNfHA
 lamindb/core/storage/_valid_suffixes.py,sha256=J08aglC9oo35pzahj0SQXW9IHib8Asp4dc11co-2uys,212
 lamindb/core/storage/_zarr.py,sha256=5ceEz6YIvgvUnVVNWhK5Z4W0WfrvyvY82Yna5jSX1_E,3661
 lamindb/core/storage/objects.py,sha256=OzvBCS-Urz5mr-O95qYt6RGBDDX5HmjfRRKWPPDn1ZE,1797
-lamindb/core/storage/paths.py,sha256=H9OPCuI7fPNRmvtQRFda92VIi6whnW6Q9BAZ6U8VWI4,8203
+lamindb/core/storage/paths.py,sha256=p5TsZUOfQAN_0kzpr0JO43hRKLc95IO5qSu5V12A8Ok,8218
+lamindb/core/subsettings/__init__.py,sha256=KFHPzIE7f7Bj4RgMjGQF4CjTdHVG_VNFBrCndo49ixo,198
+lamindb/core/subsettings/_creation_settings.py,sha256=54mfMH_osC753hpxcl7Dq1rwBD2LHnWveXtQpkLBITE,1194
+lamindb/core/subsettings/_transform_settings.py,sha256=4YbCuZtJo6zdytl6UQR4GvdDkTtT6SRBqVzofGzNOt8,583
 lamindb/integrations/__init__.py,sha256=aH2PmO2m4-vwIifMYTB0Fyyr_gZWtVnV71jT0tVWSw0,123
 lamindb/integrations/_vitessce.py,sha256=Qd39OuNsL0GXU7nMvEWLRRESFQ0mwGf_ePMJE_FDYm8,2639
 lamindb/setup/__init__.py,sha256=OwZpZzPDv5lPPGXZP7-zK6UdO4FHvvuBh439yZvIp3A,410
 lamindb/setup/core/__init__.py,sha256=SevlVrc2AZWL3uALbE5sopxBnIZPWZ1IB0NBDudiAL8,167
-lamindb-0.73.2.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-lamindb-0.73.2.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
-lamindb-0.73.2.dist-info/METADATA,sha256=bsHf6jMyHwkf2btB1WlAnrsfjN-9ue3xBK0thFSQt_s,2735
-lamindb-0.73.2.dist-info/RECORD,,
+lamindb-0.74.1.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+lamindb-0.74.1.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
+lamindb-0.74.1.dist-info/METADATA,sha256=iQeRxSkzFqxjAVMnofcMWyBaYsXLEp5gIhDeP339GNI,2732
+lamindb-0.74.1.dist-info/RECORD,,

lamindb/core/_transform_settings.py

@@ -1,9 +0,0 @@
-from __future__ import annotations
-
-
-class TransformSettings:
-    stem_uid: None | None = None
-    version: None | None = None
-
-
-transform = TransformSettings()