Running examples

Example scripts are provided in the demos/ folder and are meant to be run from inside that directory. Data files live in demos/data/.

Key demos

Data I/O and plotting

ScriptDescription
example_plot_observables.jlLoad data and produce UV coverage, V², T3φ plots
example_filter_data.jlPost-load filtering by baseline and wavelength range
example_identify_oifits_points.jlInteractive identification of data points
example_chi2_correlated.jlCorrelated χ² using OI_CORR from GRAVITY data

Model fitting

ScriptDescription
example_model_fitting_limb_darkening.jlFit limb-darkened disk models to V² data
example_model_fitting_v1295aql.jlYSO disk fitting (Hankel profiles) — Ibrahim et al. 2023
example_model_fitting_pmoired_models.jlGallery of PMOIRED-compatible model types
example_model_fitting_pmoired_conversion.jlConvert PMOIRED Python dicts to Julia
example_model_fitting_2004.jlModel fitting on Beauty Contest 2004 data
example_model_fitting_functions.jlComparing visibility functions and fitting backends
example_grid_search_limb_darkening.jlGrid search over limb-darkening parameters
example_companion_gridsearch.jlBinary companion grid search
example_companion_fastgridsearch.jlFast binary companion detection
example_binary_gridsearch.jlBinary system grid search
example_bootstrap_fit.jlBootstrap error estimation

Image reconstruction

ScriptDescription
example_image_reconstruction_basic.jlMonochromatic reconstruction with NFFT
example_image_reconstruction_polychromatic_MWC480.jlPolychromatic reconstruction with spectral regularization
example_image_reconstruction_betaLyrae.jlCHARA/MIRC β Lyrae reconstruction
example_image_reconstruction_regularization_types.jlCompare regularization types
example_image_reconstruction_regularization_weight.jlRegularization weight selection
example_image_reconstruction_lcurve.jlL-curve for regularization weight
example_image_reconstruction_support.jlSupport-constrained reconstruction
example_image_reconstruction_sparco_grey.jlSPARCO grey reconstruction (legacy)
example_image_reconstruction_sparco_grey_v1295.jlSPARCO grey for V1295 Aql (legacy)
example_image_reconstruction_sparco_grey_v1295_newAPI.jlSPARCO with reconstruct_sparco high-level API
example_image_reconstruction_oimem.jlMaximum entropy (BSMEM) reconstruction
example_image_reconstruction_pigru.jlPi Gru reconstruction
example_dirty_beam_and_image.jlDirty beam and dirty image computation

Simulation

ScriptDescription
example_simulate_observations_from_OIFITS.jlSimulate data matching an existing OIFITS file
example_simulate_observations_from_model.jlSimulate from a parametric model with array geometry
example_simulate_observations_from_image.jlSimulate from a FITS image
example_simulate_polychromatic_disk.jlPolychromatic disk with companion (OI_VIS + differential phases)
example_chara_plan.jlCHARA observation planning and Gantt chart
example_npoi_target_selection.jlNPOI target selection

Demo data

FileDescription
2004-data1.oifitsSPIE Beauty Contest 2004 synthetic dataset — used in most reconstruction examples
2004true.fitsGround-truth image for the above
betlyr6t.oifitsCHARA/MIRC data — β Lyrae
AlphaCenA.oifitsVLTI/PIONIER data — used in model fitting examples
MWC480.oifitsPolychromatic dataset for multi-channel reconstruction
rho_Cas_example.oifitsExample file for plotting demos
BC2026/OBJECT1_LM.oifitsBeauty Contest 2026 — object 1, LM band
BC2026/OBJECT1_N.oifitsBeauty Contest 2026 — object 1, N band
BC2026/OBJECT2_K.oifitsBeauty Contest 2026 — object 2, K band (GRAVITY, with OI_CORR)