Examples

Examples

Examples are longer s_*.m scripts in ../isetcam/examples/ — calculations someone wrote to answer a real question and kept because it is useful to start a new analysis from a working example. They are meant to be copied and adapted, not read start to finish like a tutorial. The source repository has well over a hundred of them, organized by topic (scene/, optics/, sensor/, metrics/, image/, color/, display/, human/, and more); the five below are representative starting points across the pipeline. Examples are not published as standalone HTML — open the linked .m source directly.

For short, didactic lessons instead, see Tutorials.

• s_sceneFromMultispectral (examples/scene/) Reads multispectral and hyperspectral scene data with sceneFromFile. Pair this with Spectral Scene Data for current datasets to download with ieWebGet.

• s_opticsMicrolens (examples/optics/) Models the microlens array placed above a sensor and shows how its placement depends on the assumptions about the main lens — a practical camera-design calculation.

• s_sensorSNR (examples/sensor/) Works through the sensor SNR formula and how pixel and sensor parameters (conversion gain, shot noise, read noise, DSNU, PRNU) determine it.

• s_metricsMacbethDeltaE (examples/metrics/) A fully automated, full-pipeline example: create a Macbeth Color Checker scene, compute the optical image and sensor response, fit a sensor-to-MCC color transform, and evaluate the rendered color error in CIELAB.

• s_ipSRGB (examples/image/) Demonstrates sRGB display calculations and their relationship to XYZ and linear RGB values, the last step before an image reaches the screen.

Checking an example before you adapt it

Before relying on any example beyond the five above:

• Confirm it is not marked deprecated in its header comment — a few older scripts under examples/human/ predate the ISETCam/ISETBio split and say so explicitly.
• Check for a % SkipFile marker near the top, which means the script is excluded from automated ieExampleTest runs (often because it requires user interaction, external data, or specific hardware).
• Run it once yourself. ieExampleTest runs the full suite; see the source repository's testing-workflow skill for how to run a single file.

Finding examples in MATLAB

s_<TAB>        % Lists all example scripts
s_scene<TAB>   % Lists example scripts for scenes
s_sensor<TAB>  % Lists example scripts for sensors