Dataset Snapshots
  • 08 Dec 2023
  • 8 Minutes to read
  • Dark
    Light
  • PDF

Dataset Snapshots

  • Dark
    Light
  • PDF

Article Summary

You can create a "snapshot" of all or some images in your project's dataset at any time. A snapshot includes the selected images and their labels, splits, metadata, tags, and labeling tasks. 

Data can't be added to a snapshot after it's created; you can think of it as "frozen". Keeping the data consistent allows you to accurately compare how different models perform on the same dataset. 

With snapshots, you can:

Create Snapshots

There are two ways that snapshots are created:

  • Manually create a snapshot, which saves the information currently in your project.
  • Train a model. LandingLens automatically saves a snapshot of your dataset when you train a model

Manually Create Snapshots

To save a snapshot:

  1. Select the images you want to include:
    • To save all images in your dataset as a snapshot, click the Snapshot icon and select Save snapshot.
      Save All Images in the Project to the Snapshot
    • To save only some images in your dataset as a snapshot, select the images you want, click Options, and select Save Snapshot.
      Save the Selected Images to the Snapshot
  2. LandingLens automatically names the snapshot with the current timestamp. If you’d like to change it, enter a custom name in the Snapshot Name field.
  3. (Optional) Enter a short description of the snapshot in the Description field.
  4. (Optional) If you want to review the splits and labeling status of the images, expand the section at the bottom.
  5. Click Save snapshot.
    Save a Snapshot

View Snapshots in the Snapshot Dashboard

To view all the snapshots for a project, click the Snapshot icon and select Show snapshot list.

Open the Snapshot Dashboard

This Snapshot dashboard allows you to review all of your snapshots and drill into each one. Here are the main sections of the Snapshot dashboard:

Snapshot Dashboard

Snapshots Panel

Click the snapshot you want to view in the Snapshots panel. Snapshots are listed in the chronological order they were created. 

By default, the Hide auto-generated snapshots checkbox is selected. This hides the snapshots that LandingLens automatically created when you trained models.  

Snapshots Panel

Images Tab

Open the Images tab to see the thumbnails for the images in the dataset. You can filter, sort, and change the sizes of the thumbnails, just as you can in the Build view.

Images Tab

Snapshot Summary Tab

Open the Snapshot Summary tab to see the number of images and classes in the snapshot, the label statuses, the split distribution, the snapshot description, the class distribution, and what models were trained using the data in the snapshot. 

Snapshot Summary Tab

Create a Custom Trained Model with a Snapshot

Note:
The default training method (also known as Fast Training) is not available for snapshots. 

You can train a model based on the data in a snapshot. This allows you to generate multiple models on different datasets in a single project.  

When you train a model based on a dataset, you will use Custom Training. For more information about how to configure Custom Training settings and hyperparameters, go to Custom Training. Additionally, training a model this way doesn't trigger LandingLens to automatically create a snapshot, because the snapshot already exists. 

To train a model on a snapshot:

  1. Click the Snapshot icon and select Show snapshot list.
    Open the Snapshot Dashboard
  2. Select the snapshot you want to use from the Snapshots panel.
    Select a Snapshot
  3. Click Use and select Train with custom options.
    Train a Custom Model on the Dataset
  4. Configure the training settings. For more information, go to Custom Training.
  5. Go to the Build page to see the model training details in the Model panel.

Create New Projects from a Snapshot

You can create a new project by copying a snapshot. When you copy a snapshot, you can choose to include the existing labels, metadata, and tags.

Copying a snapshot doesn't copy project-specific settings, such as labeling tasks and project permissions.

To create a new project from a snapshot:

  1. Click the Snapshot icon and select Show snapshot list.
    Open the Snapshot Dashboard
  2. Select the snapshot you want to use from the Snapshots panel.
    Select a Snapshot
  3. Click Use and select Create new project.
    Create New Project
  4. Enter a brief, descriptive name for your project in the New Project Name field. (You can also name the project later.)
  5. Click the project type you want the new project to be.
  6. If the selected project is the same type as the current project, you can select the Include labels checkbox to copy over the labels.
  7. If you want the new project to include the metadata or tags from the images, select the Include metadata or Include tags checkboxes, respectively.
  8. Click Create New Project.
    Set Up the Copied Project
  9. The new project opens in a new tab. (If your browser has a pop-up blocker, you might need to deactivate it or allow it to open the tab. You might need to refresh the page in the new tab to see the new project.)

Revert to a Snapshot

Caution:
If you've made any changes to the dataset in the Build tab since the last time you saved a snapshot, those changes will be lost if you revert to a snapshot. Changes include uploaded images, new labels, new metadata, new tags, and new label tasks. If you want to save any changes, save the dataset as a snapshot before you revert to another snapshot.

If you are the project Owner, you can revert your dataset (in other words, the data on the Build tab) to a snapshot. For example, let's say that you saved a snapshot and later added more images to the dataset in the Build tab. You then decide that the new images are no longer relevant to your project, so you want to go back to the snapshot you saved. You can do this by reverting to the snapshot you saved.

After you revert to a snapshot, you can change the dataset again, including changing it to a snapshot that was created later. 

Only project Owners can revert to a snapshot. The option to revert datasets does not display to other users.

To revert to a snapshot:

  1. Click the Snapshot icon and select Show snapshot list.
    Open the Snapshot Dashboard
  2. Select the snapshot you want to revert to from the Snapshots panel.
    Select a Snapshot
  3. Click Use and select Revert to this snapshot.
    Revert to This Snapshot
  4. If you want to save the data on the Build tab as a snapshot (so that you don't lose any changes), select the Save current project... checkbox.
  5. Click Yes, Revert.
    Confirm That You Want to Revert the Project to This Snapshot
  6. LandingLens closes the pop-up windows and loads the model you reverted to.

Download Pascal VOC Files

You can download the Pascal VOC files for the data in a snapshot. This allows you to upload the labeled images into other Object Detection projects in LandingLens. For more information, go to Upload Labeled Images to Object Detection Projects.

To download the Pascal VOC files for the data in a snapshot:

  1. Click the Snapshot icon and select Show snapshot list.
    Open the Snapshot Dashboard
  2. Select the snapshot you want to use from the Snapshots panel.
    Select a Snapshot
  3. Click the Action icon and select Download Pascal Voc file.
    Download the Pascal VOC File
  4. Your computer downloads the information as a .tar.bz2 file, which is a compressed (zipped) folder. 
  5. Decompress (unzip) the file to view the file contents.

Download Class Map

You can download the Class Map for the data in a snapshot. The Class Map is a JSON file that identifies the classes in the snapshot. You can use the Class Map to upload labeled images into Segmentation Projects in LandingLens. For more information, go to Upload Labeled Images to Segmentation Projects.

To download the Class Map for the data in a snapshot:

  1. Click the Snapshot icon and select Show snapshot list.
    Open the Snapshot Dashboard
  2. Select the snapshot you want to use from the Snapshots panel.
    Select a Snapshot
  3. Click the Action icon and select Download Class Map.
    Download the Class Map
  4. Your computer downloads the information in a compressed (zipped) folder. 
  5. Decompress (unzip) the folder to view the contents.

Download CSV

For Object Detection and Classification projects, you can download a CSV of information about the dataset. The CSV includes several columns of data, including Project Name, Image Name, and Split.

To download a CSV of dataset data:

  1. Click the Snapshot icon and select Show snapshot list.
    Open the Snapshot Dashboard
  2. Select the snapshot you want to use from the Snapshots panel.
    Select a Snapshot
  3. Click the Action icon and select Download CSV.
    Download the CSV File
  4. The file is downloaded to your computer. For a description of all data in the file, go to CSV Data.

CSV Data

When you download a CSV of a snapshot, the file includes the information described in the following table.

ItemDescriptionExample
media_idUnique ID assigned to the image.30243316
label_idUnique ID assigned to the set of labels on the image.

If the image has no labels, the value is blank.
27200544
media_pathThe URL of where the image is stored.

If the image has no labels, the value is blank.
s3://path/123/abc.jpg
bbox_label_pathThe URL of where the XML file with the labels is stored.

If the image has no labels, the value is blank.
s3://path/123/abc.xml
seg_label_pathIf the image is from a Segmentation project, this is the URL of where the Segmentation Mask for the image is stored.

If the image has no labels, or if the snapshot isn't from a Segmentation project, the value is blank.
s3://path/123/abc.png
media_level_labelIdentifies if the image is labeled or not.

  • NG: The image has labels.
  • OK: The image is marked as "nothing to label".
  • Blank: The image isn't labeled.
OK
defect_listA comma-separated list of the classes labeled in the image.['Bee', 'Moth']
metadataAny metadata assigned to the image.

If the image doesn't have any metadata, the value is "{}".
{"Author":"Eric Smith","Organization":"QA"}
splitThe split assigned to the image.

If the image doesn't have a split, the value is blank.
train
media_statusIdentifies if the image is labeled or not.

  • approved: The image has labels or is marked as "nothing to label".
  • raw: The image isn't labeled.
approved

Delete Snapshots

Note: 
If your project is Private, only the project Owner can delete snapshots. 

You can delete a snapshot if you no longer need it. Deleting a snapshot cannot be undone. Deleting a snapshot doesn't delete the models and evaluation jobs run with the snapshot.

To delete a snapshot:

  1. Click the Snapshot icon and select Show snapshot list.
    Open the Snapshot Dashboard
  2. Select the snapshot you want to delete from the Snapshots panel.
    Select a Snapshot
  3. Click the Action icon and select Delete this snapshot.
    Delete the Snapshot
  4. Click Delete snapshot.
    Confirm that You Want to Delete the Snapshot

Was this article helpful?

What's Next