Note

This page is generated from a Jupyter notebook. Download the .ipynb from the sources, or open the paired jupytext .py under docs/tutorials/.

Save and export

How to leave a session with rasters, RGB FITS (with provenance), transparent cutouts, session JSON, and a recreation script. Related: saving_outputs guide, component mosaic.

import multicolorfits as mcf
from multicolorfits.figures import make_combined_figure

Assume a loaded session

s = mcf.McfSession()
s.load_files(['a.fits', 'b.fits'], colors=['#C11B17', '#4CC417'], labels=['Hα', '[OIII]'])
s.compose.combine_mode = 'lab'
s.compose.title = 'My nebula'

Raster (format from extension)

# rgb = s.render_combined()
# fig, ax = make_combined_figure(s, combined=rgb)
# fig.savefig('out.png', dpi=300, bbox_inches='tight')   # also .jpg / .pdf / .svg …
#
# # Publication / stamp-friendly (no ticks):
# s.apply_bare_plot_style(transparent=True)
# fig2, ax2 = make_combined_figure(s)
# fig2.savefig('stamp.png', dpi=200, transparent=True, bbox_inches='tight')

RGB FITS + provenance

# s.save_rgb_fits('combined_rgb.fits')   # 3-plane cube + HISTORY cards
# # Low-level: mcf.save_rgb_fits(path, rgb_array, header)

Transparent cutout (slides / stamps)

# rgba = s.export_transparent_cutout(size=400, alpha_lo=55, alpha_hi=99.5)
# # Or GUI: Export transparent…
# # Helper: mcf.make_transparent_cutout(...)

Session JSON and export script

# s.save_state('session.json')
# # later:
# s2 = mcf.McfSession()
# s2.load_state('session.json')
# # mcf.gui(state='session.json')
#
# script = s.export_script()
# open('recreate.py', 'w').write(script)

Multi-panel component mosaics (hero + per-layer strip) are covered in component_mosaic — that is the preferred multi-panel figure path; a mosaic button in the GUI is deferred.

print('See guide/saving_outputs.md for details.')