PyPI - lightly-studio - Versions diffs - 0.3.1__py3-none-any.whl → 0.3.3__py3-none-any.whl - Mend

lightly-studio 0.3.1py3-none-any.whl → 0.3.3py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.

This version of lightly-studio might be problematic. Click here for more details.

Files changed (169) hide show

lightly_studio/dist_lightly_studio_view_app/_app/immutable/workers/search.worker-vNSty3B0.js ADDED Viewed

@@ -0,0 +1 @@

lightly_studio/dist_lightly_studio_view_app/_app/version.json CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":"~~1756908241758~~"}
1	+ {"version":"1759479212790"}

lightly_studio/dist_lightly_studio_view_app/index.html CHANGED Viewed

@@ -5,35 +5,35 @@
         <link rel="icon" href="/favicon.png" />
         <meta name="viewport" content="width=device-width, initial-scale=1" />
-		<link rel="modulepreload" href="/_app/immutable/entry/start.0o1H7wM9.js">
-		<link rel="modulepreload" href="/_app/immutable/chunks/CxtLVaYz.js">
-		<link rel="modulepreload" href="/_app/immutable/chunks/l7KrR96u.js">
+		<link rel="modulepreload" href="/_app/immutable/entry/start.u7zsVvqp.js">
+		<link rel="modulepreload" href="/_app/immutable/chunks/DEgUu98i.js">
+		<link rel="modulepreload" href="/_app/immutable/chunks/CH6P3X75.js">
 		<link rel="modulepreload" href="/_app/immutable/chunks/DIeogL5L.js">
 		<link rel="modulepreload" href="/_app/immutable/chunks/CYgJF_JY.js">
-		<link rel="modulepreload" href="/_app/immutable/entry/app.CjnvpsmS.js">
-		<link rel="modulepreload" href="/_app/immutable/chunks/D98V7j6A.js">
-		<link rel="modulepreload" href="/_app/immutable/chunks/XO7A28GO.js">
-		<link rel="modulepreload" href="/_app/immutable/chunks/DOlTMNyt.js">
+		<link rel="modulepreload" href="/_app/immutable/entry/app.BVr6DYqP.js">
+		<link rel="modulepreload" href="/_app/immutable/chunks/DQXoLcsF.js">
+		<link rel="modulepreload" href="/_app/immutable/chunks/DA6bFLPR.js">
+		<link rel="modulepreload" href="/_app/immutable/chunks/BfHVnyNT.js">
 		<link rel="modulepreload" href="/_app/immutable/chunks/CWj6FrbW.js">
 		<link rel="modulepreload" href="/_app/immutable/chunks/69_IOA4Y.js">
-		<link rel="modulepreload" href="/_app/immutable/chunks/C8I8rFJQ.js">
-		<link rel="modulepreload" href="/_app/immutable/chunks/D6RI2Zrd.js">
-		<link rel="modulepreload" href="/_app/immutable/chunks/DjfY96ND.js">
-		<link rel="modulepreload" href="/_app/immutable/chunks/Bu7uvVrG.js">
+		<link rel="modulepreload" href="/_app/immutable/chunks/Cs1XmhiF.js">
+		<link rel="modulepreload" href="/_app/immutable/chunks/DGTPl6Gk.js">
+		<link rel="modulepreload" href="/_app/immutable/chunks/D4whDBUi.js">
+		<link rel="modulepreload" href="/_app/immutable/chunks/RmD8FzRo.js">
     </head>
     <body data-sveltekit-preload-data="hover" class="flex h-screen w-screen flex-col dark:bg-black">
         <div style="display: contents">
 			<script>
 				{
-					__sveltekit_vpwkcc = {
+					__sveltekit_1gqf9ui = {
 						base: ""
 					};
 					const element = document.currentScript.parentElement;
 					Promise.all([
-						import("/_app/immutable/entry/start.0o1H7wM9.js"),
-						import("/_app/immutable/entry/app.CjnvpsmS.js")
+						import("/_app/immutable/entry/start.u7zsVvqp.js"),
+						import("/_app/immutable/entry/app.BVr6DYqP.js")
 					]).then(([kit, app]) => {
 						kit.start(app, element);
 					});

lightly_studio/examples/example.py CHANGED Viewed

@@ -1,23 +1,24 @@
-"""Example of how to use the DatasetLoader class."""
+"""Example of how to load samples from path with the dataset class."""
+from pathlib import Path
 from environs import Env
-from lightly_studio import DatasetLoader
+import lightly_studio as ls
 # Read environment variables
 env = Env()
 env.read_env()
-# Create a DatasetLoader instance
-loader = DatasetLoader()
+# Define the path to the dataset directory
+dataset_path = Path(env.path("DATASET_PATH", "/path/to/your/dataset"))
+dataset_path = dataset_path.parent if dataset_path.is_file() else dataset_path
-# Define the path to the dataset (folder containing data.yaml)
-dataset_path = env.path("DATASET_PATH", "/path/to/your/yolo/dataset/data.yaml")
+# Create a DatasetLoader from a path
+dataset = ls.Dataset.create()
+dataset.add_samples_from_path(path=dataset_path)
-# Load YOLO dataset using data.yaml path
-loader.from_yolo(
-    str(dataset_path),
-    input_split=env.str("LIGHTLY_STUDIO_DATASET_SPLIT", "test"),
-)
+for sample in dataset:
+    print(sample)
-loader.start_gui()
+ls.start_gui()

lightly_studio/examples/example_coco.py ADDED Viewed

@@ -0,0 +1,13 @@
+"""Example of how to add samples in coco format to a dataset."""
+import lightly_studio as ls
+# Create a DatasetLoader from a path
+dataset = ls.Dataset.create()
+dataset.add_samples_from_coco(
+    annotations_json="/path/to/your/dataset",
+    images_path="/path/to/your/dataset",
+    annotation_type=ls.AnnotationType.INSTANCE_SEGMENTATION,
+)
+ls.start_gui()

lightly_studio/examples/example_metadata.py CHANGED Viewed

@@ -16,14 +16,11 @@ from uuid import UUID
 from environs import Env
 from sqlmodel import Session
-from lightly_studio import DatasetLoader
-from lightly_studio.api.db import db_manager
+import lightly_studio as ls
+from lightly_studio import db_manager
+from lightly_studio.core.sample import Sample
 from lightly_studio.metadata.gps_coordinate import GPSCoordinate
-from lightly_studio.models.dataset import DatasetTable
-from lightly_studio.resolvers import (
-    metadata_resolver,
-    sample_resolver,
-)
+from lightly_studio.resolvers import metadata_resolver
 from lightly_studio.resolvers.metadata_resolver.metadata_filter import Metadata
 from lightly_studio.resolvers.samples_filter import SampleFilter
@@ -34,25 +31,24 @@ dataset_path = env.path("DATASET_PATH", "/path/to/your/yolo/dataset/data.yaml")
 LIGHTLY_STUDIO_DATASET_SPLIT = env.str("LIGHTLY_STUDIO_DATASET_SPLIT", "test")
-def load_existing_dataset() -> tuple[DatasetTable, list[UUID], DatasetLoader]:
+def load_existing_dataset() -> tuple[ls.Dataset, list[Sample]]:
     """Load an existing dataset using DatasetLoader.
     Returns:
-        Tuple of (dataset, sample_ids, loader).
+        Tuple of (dataset, samples).
     """
     print(" Loading existing dataset...")
-    loader = DatasetLoader()
-    dataset = loader.from_yolo(
-        str(dataset_path),
+    dataset = ls.Dataset.create()
+    dataset.add_samples_from_yolo(
+        data_yaml=str(dataset_path),
         input_split=LIGHTLY_STUDIO_DATASET_SPLIT,
     )
-    # Get all sample IDs from the dataset
-    samples = dataset.get_samples()
-    sample_ids = [s.sample_id for s in samples]
+    # Get all samples from the dataset
+    samples = dataset.query().to_list()
-    print(f"✅ Loaded dataset with {len(sample_ids)} samples")
-    return dataset, sample_ids, loader
+    print(f"✅ Loaded dataset with {len(samples)} samples")
+    return dataset, samples
 def add_bulk_metadata(session: Session, sample_ids: list[UUID]) -> None:
@@ -93,56 +89,38 @@ def add_bulk_metadata(session: Session, sample_ids: list[UUID]) -> None:
     print(f"✅ Added metadata to {len(sample_ids)} samples in {elapsed_time:.2f}s")
-def add_individual_metadata(session: Session, sample_ids: list[UUID]) -> None:
+def add_individual_metadata(samples: list[Sample]) -> None:
     """Add metadata to individual samples."""
     print("\n Adding individual metadata to specific samples...")
     # Add metadata to first 5 samples individually
-    for i, sample_id in enumerate(sample_ids[:5]):
+    for i, sample in enumerate(samples[:5]):
+        print(f" Adding metadata to sample {sample.file_name} {sample.sample_id}...")
         # Add some specific metadata
-        metadata_resolver.set_value_for_sample(
-            session=session,
-            sample_id=sample_id,
-            key="special_metadata",
-            value=f"sample_{i + 1}_special",
+        sample.metadata["special_metadata"] = f"sample_{i + 1}_special"
+        sample.metadata["priority"] = random.randint(1, 10)
+        sample.metadata["list"] = [1, 2, 3]
+        sample.metadata["custom_gps"] = GPSCoordinate(
+            lat=40.7128 + i * 0.1,  # Slightly different coordinates
+            lon=-74.0060 + i * 0.1,
         )
-        metadata_resolver.set_value_for_sample(
-            session=session,
-            sample_id=sample_id,
-            key="priority",
-            value=random.randint(1, 10),
-        )
-        metadata_resolver.set_value_for_sample(
-            session=session,
-            sample_id=sample_id,
-            key="list",
-            value=[1, 2, 3],
-        )
-        metadata_resolver.set_value_for_sample(
-            session=session,
-            sample_id=sample_id,
-            key="custom_gps",
-            value=GPSCoordinate(
-                lat=40.7128 + i * 0.1,  # Slightly different coordinates
-                lon=-74.0060 + i * 0.1,
-            ),
-        )
+    print(f"✅ Added individual metadata to {min(5, len(samples))} samples")
-    print(f"✅ Added individual metadata to {min(5, len(sample_ids))} samples")
-def demonstrate_bulk_metadata_filters(dataset: DatasetTable) -> None:
+def demonstrate_bulk_metadata_filters(dataset: ls.Dataset) -> None:
     """Demonstrate filtering with bulk-added metadata."""
+    # TODO(Michal, 09/2025): Update with native metadata filtering instead of accessing
+    # `dataset._inner` when implemented.
+    dataset_table = dataset._inner  # noqa: SLF001
     print("\n Bulk Metadata Filters:")
     print("=" * 50)
     # Filter by temperature
     print("\n1. Filter by temperature > 25:")
     filter_temp = SampleFilter(metadata_filters=[Metadata("temperature") > 25])  # noqa PLR2004
-    samples = dataset.get_samples(filters=filter_temp)
+    samples = dataset_table.get_samples(filters=filter_temp)
     print(f"   Found {len(samples)} samples with temperature > 25")
     for sample in samples[:3]:  # Show first 3
         print(f" {sample.file_name}: {sample['temperature']}")
@@ -150,7 +128,7 @@ def demonstrate_bulk_metadata_filters(dataset: DatasetTable) -> None:
     # Filter by location
     print("\n2. Filter by location == 'city':")
     filter_location = SampleFilter(metadata_filters=[Metadata("location") == "city"])
-    samples = dataset.get_samples(filters=filter_location)
+    samples = dataset_table.get_samples(filters=filter_location)
     print(f"   Found {len(samples)} samples from cities")
     for sample in samples[:3]:  # Show first 3
         print(f" {sample.file_name}: {sample['location']}")
@@ -158,7 +136,7 @@ def demonstrate_bulk_metadata_filters(dataset: DatasetTable) -> None:
     # Filter by GPS coordinates
     print("\n3. Filter by latitude > 0° (Northern hemisphere):")
     filter_lat = SampleFilter(metadata_filters=[Metadata("gps_coordinates.lat") > 0])
-    samples = dataset.get_samples(filters=filter_lat)
+    samples = dataset_table.get_samples(filters=filter_lat)
     print(f"   Found {len(samples)} samples in Northern hemisphere")
     for sample in samples[:3]:  # Show first 3
         gps = sample["gps_coordinates"]
@@ -169,14 +147,18 @@ def demonstrate_bulk_metadata_filters(dataset: DatasetTable) -> None:
     filter_confidence = SampleFilter(
         metadata_filters=[Metadata("confidence") > 0.9]  # noqa PLR2004
     )
-    samples = dataset.get_samples(filters=filter_confidence)
+    samples = dataset_table.get_samples(filters=filter_confidence)
     print(f"   Found {len(samples)} samples with confidence > 0.9")
     for sample in samples[:3]:  # Show first 3
         print(f"   📸 {sample.file_name}: confidence={sample['confidence']:.3f}")
-def demonstrate_individual_metadata_filters(dataset: DatasetTable) -> None:
+def demonstrate_individual_metadata_filters(dataset: ls.Dataset) -> None:
     """Demonstrate filtering with individually-added metadata."""
+    # TODO(Michal, 09/2025): Update with native metadata filtering instead of accessing
+    # `dataset._inner` when implemented.
+    dataset_table = dataset._inner  # noqa: SLF001
     print("\n Individual Metadata Filters:")
     print("=" * 50)
@@ -185,7 +167,7 @@ def demonstrate_individual_metadata_filters(dataset: DatasetTable) -> None:
     filter_special = SampleFilter(
         metadata_filters=[Metadata("special_metadata") == "sample_1_special"]
     )
-    samples = dataset.get_samples(filters=filter_special)
+    samples = dataset_table.get_samples(filters=filter_special)
     print(f"   Found {len(samples)} samples with special metadata")
     for sample in samples:
         print(f" {sample.file_name}: {sample['special_metadata']}")
@@ -193,7 +175,7 @@ def demonstrate_individual_metadata_filters(dataset: DatasetTable) -> None:
     # Filter by priority
     print("\n2. Filter by high priority (> 7):")
     filter_priority = SampleFilter(metadata_filters=[Metadata("priority") > 7])  # noqa PLR2004
-    samples = dataset.get_samples(filters=filter_priority)
+    samples = dataset_table.get_samples(filters=filter_priority)
     print(f"   Found {len(samples)} samples with priority > 7")
     for sample in samples:
         print(f" {sample.file_name}: priority={sample['priority']}")
@@ -203,15 +185,19 @@ def demonstrate_individual_metadata_filters(dataset: DatasetTable) -> None:
     filter_custom_gps = SampleFilter(
         metadata_filters=[Metadata("custom_gps.lat") > 40.8]  # noqa PLR2004
     )
-    samples = dataset.get_samples(filters=filter_custom_gps)
+    samples = dataset_table.get_samples(filters=filter_custom_gps)
     print(f"   Found {len(samples)} samples with custom GPS lat > 40.8")
     for sample in samples:
         gps = sample["custom_gps"]
         print(f" {sample.file_name}: lat={gps.lat:.4f}, lon={gps.lon:.4f}")
-def demonstrate_combined_filters(dataset: DatasetTable) -> None:
+def demonstrate_combined_filters(dataset: ls.Dataset) -> None:
     """Demonstrate combining multiple filters."""
+    # TODO(Michal, 09/2025): Update with native metadata filtering instead of accessing
+    # `dataset._inner` when implemented.
+    dataset_table = dataset._inner  # noqa: SLF001
     print("\n Combined Filters:")
     print("=" * 50)
@@ -224,7 +210,7 @@ def demonstrate_combined_filters(dataset: DatasetTable) -> None:
             Metadata("temperature") > 25,  # noqa PLR2004
         ]
     )
-    samples = dataset.get_samples(filters=filter_combined)
+    samples = dataset_table.get_samples(filters=filter_combined)
     print(f"   Found {len(samples)} samples matching all criteria")
     for sample in samples[:3]:
         print(
@@ -241,64 +227,64 @@ def demonstrate_combined_filters(dataset: DatasetTable) -> None:
             Metadata("location") == "city",
         ]
     )
-    samples = dataset.get_samples(filters=filter_gps_combined)
+    samples = dataset_table.get_samples(filters=filter_gps_combined)
     print(f"   Found {len(samples)} samples in northern hemisphere cities with high confidence")
     for sample in samples[:3]:
         gps = sample["gps_coordinates"]
         print(f" {sample.file_name}: lat={gps.lat:.4f}, conf={sample['confidence']:.2f}")
-def demonstrate_dictionary_like_access(session: Session, sample_ids: list[UUID]) -> None:
+def demonstrate_dictionary_like_access(samples: list[Sample]) -> None:
     """Demonstrate adding metadata using dictionary-like access."""
     print("\n Dictionary-like Metadata Access:")
     print("=" * 50)
     # Get the first few samples to demonstrate
-    samples = sample_resolver.get_many_by_id(session, sample_ids[:2])
+    samples = samples[:2]
-    print("\n1. Adding metadata using sample['key'] = value syntax:")
+    print("\n1. Adding metadata using sample.metadata['key'] = value syntax:")
     # Add different types of metadata to different samples
-    samples[0]["temperature"] = 25
-    samples[0]["location"] = "city"
-    samples[0]["is_processed"] = True
-    samples[0]["confidence"] = 0.95
+    samples[0].metadata["temperature"] = 25
+    samples[0].metadata["location"] = "city"
+    samples[0].metadata["is_processed"] = True
+    samples[0].metadata["confidence"] = 0.95
     print(
-        f" {samples[0].file_name}: temp={samples[0]['temperature']}°C, "
-        f"location={samples[0]['location']},"
-        f" processed={samples[0]['is_processed']}"
+        f" {samples[0].file_name}: temp={samples[0].metadata['temperature']}°C, "
+        f"location={samples[0].metadata['location']},"
+        f" processed={samples[0].metadata['is_processed']}"
     )
-    samples[1]["temperature"] = 15
-    samples[1]["location"] = "mountain"
-    samples[1]["gps_coordinates"] = GPSCoordinate(lat=40.7128, lon=-74.0060)
-    samples[1]["tags"] = ["outdoor", "nature", "landscape"]
+    samples[1].metadata["temperature"] = 15
+    samples[1].metadata["location"] = "mountain"
+    samples[1].metadata["gps_coordinates"] = GPSCoordinate(lat=40.7128, lon=-74.0060)
+    samples[1].metadata["tags"] = ["outdoor", "nature", "landscape"]
     print(
-        f" {samples[1].file_name}: temp={samples[1]['temperature']}°C, "
-        f"location={samples[1]['location']}, tags={samples[1]['tags']}"
+        f" {samples[1].file_name}: temp={samples[1].metadata['temperature']}°C, "
+        f"location={samples[1].metadata['location']}, tags={samples[1].metadata['tags']}"
     )
     # Demonstrate reading metadata
-    print("\n2. Reading metadata using sample['key'] syntax:")
+    print("\n2. Reading metadata using sample.metadata['key'] syntax:")
     for sample in samples:
         print(f" {sample.file_name}:")
-        print(f"      Temperature: {sample['temperature']}°C")
-        print(f"      Location: {sample['location']}")
-        gps = sample["gps_coordinates"]
+        print(f"      Temperature: {sample.metadata['temperature']}°C")
+        print(f"      Location: {sample.metadata['location']}")
+        gps = sample.metadata["gps_coordinates"]
         print(f"      GPS: lat={gps.lat:.4f}, lon={gps.lon:.4f}")
-        print(f"      Tags: {sample['tags']}")
+        print(f"      Tags: {sample.metadata['tags']}")
     # Demonstrate None return for missing keys
-    print("  Note: sample['key'] returns None for missing keys")
-    missing_value = samples[0]["nonexistent_key"]
+    print("  Note: sample.metadata['key'] returns None for missing keys")
+    missing_value = samples[0].metadata["nonexistent_key"]
     if missing_value is None:
-        print(f" sample['nonexistent_key']: {missing_value}")
+        print(f" sample.metadata['nonexistent_key']: {missing_value}")
     print(f"✅ Added metadata to {len(samples)} samples using dictionary-like access")
     # Demonstrate schema presentation
     try:
-        samples[0]["temperature"] = "string_value"  # Invalid type for demonstration
+        samples[0].metadata["temperature"] = "string_value"  # Invalid type for demonstration
         print(f" ❌ This should not print: {missing_value}")
     except ValueError:
         print(" ✅ Correctly raised ValueError for invalid type")
@@ -308,22 +294,21 @@ def main() -> None:
     """Main function to demonstrate  metadata functionality."""
     try:
         # Load existing dataset
-        dataset, sample_ids, loader = load_existing_dataset()
+        dataset, samples = load_existing_dataset()
-        with db_manager.session() as session:
-            # Add bulk metadata
-            add_bulk_metadata(session, sample_ids)
+        # Add bulk metadata
+        add_bulk_metadata(db_manager.persistent_session(), [s.sample_id for s in samples])
-            # Add individual metadata
-            add_individual_metadata(session, sample_ids)
+        # Add individual metadata
+        add_individual_metadata(samples)
-            # Demonstrate different types of filtering
-            demonstrate_bulk_metadata_filters(dataset)
-            demonstrate_individual_metadata_filters(dataset)
-            demonstrate_combined_filters(dataset)
-            demonstrate_dictionary_like_access(session, sample_ids)
+        # Demonstrate different types of filtering
+        demonstrate_bulk_metadata_filters(dataset)
+        demonstrate_individual_metadata_filters(dataset)
+        demonstrate_combined_filters(dataset)
+        demonstrate_dictionary_like_access(samples)
-            loader.start_gui()
+        ls.start_gui()
     except ValueError as e:
         print(f"❌ Error: {e}")

lightly_studio/examples/example_selection.py CHANGED Viewed

@@ -4,8 +4,7 @@ from pathlib import Path
 from environs import Env
-from lightly_studio import DatasetLoader
-from lightly_studio.selection.select import Selection
+import lightly_studio as ls
 # Read environment variables
 env = Env()
@@ -15,25 +14,14 @@ env.read_env()
 dataset_path = Path(env.path("DATASET_PATH", "/path/to/your/dataset"))
 dataset_path = dataset_path.parent if dataset_path.is_file() else dataset_path
-# Create a DatasetLoader from a path
-loader = DatasetLoader()
-dataset = loader.from_directory(
-    dataset_name="clothing_small_test",
-    img_dir=str(dataset_path),
-)
-# Create the selection interface
-# TODO(Malte, 08/2025): Replace this with using a DatasetView.
-# See the Select class for more details on the TODO.
-select = Selection(
-    dataset_id=dataset.dataset_id,
-    session=loader.session,
-)
+# Create a Dataset from a path
+dataset = ls.Dataset.create()
+dataset.add_samples_from_path(path=str(dataset_path))
-# Select a diverse subset of 10 samples.
-select.diverse(
+# Run selection via the dataset query
+dataset.query().selection().diverse(
     n_samples_to_select=10,
     selection_result_tag_name="diverse_selection",
 )
-loader.start_gui()
+ls.start_gui()

lightly-studio 0.3.1__py3-none-any.whl → 0.3.3__py3-none-any.whl

Potentially problematic release.

lightly-studio 0.3.1py3-none-any.whl → 0.3.3py3-none-any.whl