Step-by-step tutorial · Updated September 11, 2026

From scans to figures, signal plots, and survival curves

Work through a small longitudinal study using Scans → Figure → Plot. Start in Simple mode; use Advanced when you need manual scale settings or ROI controls. Open the app in a second tab so you can keep these instructions visible.

1. Import and check scans

  1. Choose + New experiment and name it “Two-group example”. Use Import or drag acquisition folders into the app.
  2. Keep each folder’s ClickInfo.txt and luminescent.TIF together. Include photograph.TIF if available. You can import a parent folder containing multiple acquisitions.
  3. In Scans, check each acquisition date and time-point assignment. Both September 1 cages should belong to the same time point; repeat for September 8 and 15.
Expected result: six scans, three time points. Folder names help identify scans, but verify the actual dates imported from metadata.

Standalone TIFF, PNG, and JPEG files are rendered-only panels. They cannot recover quantitative radiance or provide calibrated ROI measurements. Native .amix and .aurax projects are not opened; unzip acquisition folders before importing.

Normalized radiance compares previews on a shared scale. Turn it off to inspect a dim scan using its own range. Colors then cannot be compared between scans. This preview setting affects the radiance layer only; it leaves the photograph, figure scale, plots, and measurements unchanged. Set aside saturated exposures when a suitable unsaturated acquisition is available.

2. Identify animals and groups

  1. Open the crop tool from a scan. Draw a rectangle or a freehand outline around each animal and assign its name. Use C1/C2 in the control cage and T1/T2 in the treatment cage.
  2. On later dates, assign the same animal identities. A new name creates a different animal rather than a follow-up measurement.
  3. Selections save automatically as you draw and edit. Use Previous cage and Next cage to continue; check the save status before leaving.
  4. Create Control and Treatment groups and assign animals. In Figure, use Groups & treatments; in other views, use the Groups sidebar.

You can also use Animals → + Add to generate numbered names or paste a spreadsheet column such as:

C1
C2
T1
T2

Automatic mouse detection and outline editing are beta. Review proposed boundaries, separate touching animals, and confirm identities on every scan. A suggested outline is not a validated measurement region.

3. Build a shared-scale figure

  1. Select Figure and Panel view → Individual animals. With all example assignments complete, expect four animals across three time points: 12 panels.
  2. Choose Mouse order → Group to keep treatments together. Use Mouse name or Custom order when appropriate. Remove side padding fits panels to their crops.
  3. Click Normalize all. Check the shared color bar. Advanced exposes manual min/max, log/linear mapping, and colormap controls.
  4. For cage-level presentation, switch to Whole scans. Choose animal outlines or a group-composition strip; review the cage label.
  5. Review labels, missing panels, crops, and any pre-export issues. Choose Export figure for the displayed figure as a 300 dpi PNG.
Display example: with a shared range of 10,000–1,000,000, a radiance value of 100,000 receives the same color on every quantitative panel. Changing that range changes colors, not raw counts or ROI values. This is display normalization, not division by baseline or correction for biological variability.

4. Plot signal and export measurements

  1. Open Plot → Signal over time. Choose Lines → Individual animals and a metric: Total flux, Mean radiance, or Max radiance. Hover an individual line to see which animal it represents.
  2. Choose Name, Date, or Day # labels. For this example, use Day # and First image = Day 0; the three dates are days 0, 7, and 14.
  3. Switch to Group summary for Mean or Median with Standard deviation or Standard error. Check visible groups and the selected summary before export. Use Linear Y to inspect zero values, which cannot be displayed on a logarithmic axis.
  4. Download CSV for data, SVG (vector) for an editable plot, or Export plot for a 300 dpi PNG. Plot image exports include the group legend.

Without an explicit measurement ROI, signal plots use the animal’s crop rectangle or freehand contour. An explicit ROI is separate from the crop and decorative panel border. Keep region selection consistent across dates. Advanced ROI controls expose measurements and a project-wide ROI CSV export; dashed measurement overlays are omitted from exported figures.

Total flux is an estimate calculated from summed radiance × pixel area with the steradian term treated as 1 sr. It may differ from Living Image’s absolute flux. Validate cross-software comparisons; retain the metric, units, and ROI method with exported results.

5. Work through a survival example

In Plot → Survival, open Death dates…. Day 0 defaults to the first scan; set it to your study’s actual reference date when needed. This fictional example uses September 1, 2026:

Illustrative entries and expected event/censor times
AnimalDeath dateLast scanExpected outcome
C1September 10September 8Event at day 9
C2Leave blankSeptember 15Censored at day 14
T1Leave blankSeptember 15Censored at day 14
T2Leave blankSeptember 15Censored at day 14

For this variation, C1 has no September 15 acquisition or assigned panel. Control survival drops to 50% at day 9; Treatment remains at 100% through its last observation. Blank death dates mean censoring at the last scan, not confirmed survival to an arbitrary study-end date.

Check censor ticks, the optional number-at-risk table, median guides, and the visible groups. The app reports group medians and a log-rank comparison across visible groups; this four-animal illustration is for learning the controls, not drawing treatment conclusions. Survival has its own CSV, SVG, and 300 dpi PNG exports.

6. Back up and share

Signed-out work saves in this browser on this device. Open an experiment and choose Download backup in the editor for a .sbli archive; use Import backup to restore one. Keep the original acquisition files too.

Sign in for private cloud backup and wait for Backed up. Free accounts keep 2 active cloud experiments, Plus keeps 10, and Unlimited has no experiment-count limit. Each cloud archive is limited to 1 GB. Failed backups offer Retry; local saving and confirmed cloud backup are separate states. Avoid editing the same experiment on multiple devices simultaneously.

Share creates a public view-only link to the latest cloud-backed experiment. Anyone with that link can browse and export its scans, results, groups, and imported metadata. Use Revoke link to disable access or Replace link to invalidate the old URL. Cloud deletion normally moves an experiment to Trash for 30 days; Delete forever is permanent.

Quick troubleshooting

Open SimpleBLI · File compatibility and IVIS guide · Contact support