Step-by-step tutorial · Updated September 14, 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 to 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.
SimpleBLI Scans view showing many anonymized real quantitative BLI acquisitions
Real large-experiment example: review many scans, quantitative status, time-point assignments, and exposure warnings from one workspace. Public labels and dates are anonymized.
SimpleBLI Animals view showing anonymized mouse identities beside real BLI scans
Animal workflow: create or reuse neutral animal identities so the same mouse stays connected across cages and time points.

Standalone TIFF, PNG, and JPEG files are rendered-only panels. They cannot recover quantitative radiance or provide calibrated ROI measurements. Project files with .amix or .aurax extensions 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. For a large experiment, choose Auto-detect mice to propose outlines from the photograph. Accept or dismiss each proposal, reshape an accepted outline when needed, and assign the animal’s name. You can also draw a rectangle or freehand mouse outline manually. 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.
SimpleBLI Auto-detect mice feature proposing dashed outlines that can be accepted or dismissed
Auto-detect mice: proposed outlines appear on the photo preview with individual Accept and dismiss controls. The example includes artifact proposals: keep the mouse-shaped outlines and dismiss the rest before assigning identities.
SimpleBLI proposing editable outlines on a second anonymized real five-mouse scan
Another real cage: five useful mouse proposals and one obvious artifact show why automatic tracing is a fast starting point—not a substitute for review.
SimpleBLI proposing five editable outlines on a third anonymized real multi-mouse scan
One more real example: detector performance varies by pose, contrast, and contact between animals. Accept, dismiss, move, or reshape each suggestion.

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

C1
C2
T1
T2

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.
SimpleBLI Figure view with individual mice in rows, time points in columns, and one shared radiance scale
Figure view: individual animals are aligned across time points under one radiance color bar. Displayed signal is comparable across every quantitative panel.
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.
SimpleBLI Plot view displaying longitudinal total flux for individually colored control and experimental animals
Plot view: switch between individual animals and group summaries, select the measurement metric, and export the chart or its underlying data.

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. Values from other software are not guaranteed to match. Validate cross-software comparisons; retain the metric, units, and ROI method with exported results.

5. Work through a survival example

Open Animals → Edit survival data (or Plot → Survival → Edit survival data…). Every animal also has its own survival Edit link in the Animals list. Check Dead / censored for a death date, and mark deaths unrelated to tumor as Non-tumor death (censor). For a living animal checked after its last BLI scan, enter Last known alive. To use one alive-check date for all animals without a recorded death, choose the date and click Apply to all without death; this replaces their existing alive dates but does not change death dates. Set Day 0 here if the study start differs from the first scan, then select Save dates. This fictional example uses September 1, 2026:

Illustrative entries and expected event/censor times
AnimalDeath dateLast scanLast known aliveExpected outcome
C1September 10September 8—Event at day 9
C2Leave blankSeptember 15September 20Censored at day 19
T1Leave blankSeptember 15—Censored at day 14
T2Leave blankSeptember 15—Censored 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. C2 has no BLI scan after September 15, but its September 20 alive check extends follow-up to day 19. Without a death date or an alive check after the final scan, the animal is censored at its last scan. A dated non-tumor death is censored on its recorded 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