{
 "cells": [
  {
   "cell_type": "markdown",
   "id": "36ffb2c4",
   "metadata": {},
   "source": [
    "# Component mosaic\n",
    "\n",
    "Hero combined image + per-layer colorized strip on a shared WCS.  Guide\n",
    "(with light/dark layout figures):\n",
    "[figures_and_mosaics](../guide/figures_and_mosaics.md)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "e414bca5",
   "metadata": {},
   "outputs": [],
   "source": [
    "import multicolorfits as mcf"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "4969f676",
   "metadata": {},
   "source": [
    "## Basic call\n",
    "\n",
    "```python\n",
    "s = mcf.McfSession()\n",
    "s.load_files([...], colors=[...], labels=[...])\n",
    "s.compose.combine_mode = 'lab'\n",
    "\n",
    "fig, axes = mcf.make_component_mosaic(\n",
    "    s,\n",
    "    components='top',      # strip above hero; also bottom / left / right\n",
    "    max_per_line=3,\n",
    "    ticks='plain',          # plain | minimal | full\n",
    "    overlays='hero',        # beam/compass/scale bar on hero only\n",
    ")\n",
    "fig.savefig('mosaic.png', dpi=150, bbox_inches='tight')\n",
    "```\n",
    "\n",
    "`axes['combined']` is the hero; `axes['components']` is the list of layer\n",
    "panels.  Empty leftover cells in the strip stay blank for custom annotations.\n",
    "\n",
    "Local regen scratch: `examples/output/component_mosaic/` → copy into\n",
    "`docs/_static/mosaics/` via `docs/make_docs_figures.py` (not committed)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "1239c038",
   "metadata": {},
   "outputs": [],
   "source": [
    "print('mcf.make_component_mosaic — see guide/figures_and_mosaics.md')"
   ]
  }
 ],
 "metadata": {
  "jupytext": {
   "formats": "ipynb,py:percent",
   "kernelspec": {
    "display_name": "Python 3",
    "name": "python3"
   },
   "main_language": "python"
  },
  "language_info": {
   "name": "python"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 5
}