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
- Choose + New experiment and name it “Two-group example”. Use Import or drag acquisition folders into the app.
- Keep each folder’s
ClickInfo.txtandluminescent.TIFtogether. Includephotograph.TIFif available. You can import a parent folder containing multiple acquisitions. - 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.
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
- 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.
- On later dates, assign the same animal identities. A new name creates a different animal rather than a follow-up measurement.
- Selections save automatically as you draw and edit. Use Previous cage and Next cage to continue; check the save status before leaving.
- 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
- Select Figure and Panel view → Individual animals. With all example assignments complete, expect four animals across three time points: 12 panels.
- Choose Mouse order → Group to keep treatments together. Use Mouse name or Custom order when appropriate. Remove side padding fits panels to their crops.
- Click Normalize all. Check the shared color bar. Advanced exposes manual min/max, log/linear mapping, and colormap controls.
- For cage-level presentation, switch to Whole scans. Choose animal outlines or a group-composition strip; review the cage label.
- Review labels, missing panels, crops, and any pre-export issues. Choose Export figure for the displayed figure as a 300 dpi PNG.
4. Plot signal and export measurements
- 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.
- 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.
- 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.
- 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:
| Animal | Death date | Last scan | Expected outcome |
|---|---|---|---|
| C1 | September 10 | September 8 | Event at day 9 |
| C2 | Leave blank | September 15 | Censored at day 14 |
| T1 | Leave blank | September 15 | Censored at day 14 |
| T2 | Leave blank | September 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. 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
- No signal plot: check quantitative import status, animal assignments, time points, and populated crop panels.
- A dim animal looks bright in Scans: check Normalized radiance; per-scan stretching is for inspection.
- Unexpected survival times: check acquisition dates, Day 0, death dates, and last-scan censoring.
- Missing figure cells: verify that you reused the same animal identity and selected the correct time point.
- Backup not confirmed: retain the local work, check the status and size message, and retry when connected.
Open SimpleBLI · File compatibility and IVIS guide · Contact support