=======================================
zall-tilecumulative-SPECPROD-extra.fits
=======================================

:Summary: Concatenation of all ``ztile-*-cumulative-extra.fits`` files,
          combining all extra columns across all TILEs, SURVEYs, and PROGRAMs.
:Naming Convention: ``zcatalog/v2/zall/zall-tilecumulative-{SPECPROD}-extra.fits``, where
    ``{SPECPROD}`` is the official name of the full reduction, *e.g.* ``iron``.
:Regex: ``zall-tilecumulative-[a-z0-9_-]+-extra\.fits``
:File Type: FITS, ~200 GB

This file is row-matched to
:doc:`zall-tilecumulative-SPECPROD.fits <./zall-tilecumulative-SPECPROD>` and
contains the extra columns stacked from all
:doc:`ztile-*-cumulative-extra.fits <../SURVEY/ztile-SURVEY-PROGRAM-GROUPTYPE-extra>`
files.

Contents
========

====== =============== ======== ============================================================
Number EXTNAME         Type     Contents
====== =============== ======== ============================================================
HDU0_  PRIMARY         IMAGE    Empty
HDU1_  ZCATALOG_EXTRA  BINTABLE All extra columns not in core or imaging files
====== =============== ======== ============================================================


FITS Header Units
=================

HDU0
----

EXTNAME = PRIMARY

Required Header Keywords
~~~~~~~~~~~~~~~~~~~~~~~~

.. collapse:: Required Header Keywords Table

    .. rst-class:: keywords

    ============ ================ ==== =======================
    KEY          Example Value    Type Comment
    ============ ================ ==== =======================
    CHECKSUM     9aaGCVYE9aaECUYE str  HDU checksum
    DATASUM      0                str  data unit checksum
    ZCATVER      v2               str  Version of zcatalog files
    ============ ================ ==== =======================

Empty HDU.

HDU1
----

EXTNAME = ZCATALOG_EXTRA

All extra columns stacked from all
:doc:`ztile-SURVEY-PROGRAM-GROUPTYPE-extra.fits <../SURVEY/ztile-SURVEY-PROGRAM-GROUPTYPE-extra>`
cumulative files. Column definitions are identical to that file; see it for
full descriptions. Note that ``FIRSTNIGHT`` is included here (from the
cumulative tile coadds) but not in the zall-tilecumulative core file.

Required Header Keywords
~~~~~~~~~~~~~~~~~~~~~~~~

.. collapse:: Required Header Keywords Table

    .. rst-class:: keywords

    ============ ================ ==== =======================
    KEY          Example Value    Type Comment
    ============ ================ ==== =======================
    NAXIS1       882              int  width of table in bytes
    NAXIS2       10000000         int  number of rows in table
    CHECKSUM     QA6lQ26iQ96iQ96i str  HDU checksum
    DATASUM      4284326946       str  data unit checksum
    ZCATVER      v2               str  Version of zcatalog files
    ============ ================ ==== =======================

Required Data Table Columns
~~~~~~~~~~~~~~~~~~~~~~~~~~~

See `HDU1 of ztile-SURVEY-PROGRAM-GROUPTYPE-extra.fits <../SURVEY/ztile-SURVEY-PROGRAM-GROUPTYPE-extra.html#hdu1>`_
for the full column list. The zall-tilecumulative-SPECPROD-extra file contains the same
columns, with rows stacked from all surveys, programs, and tiles.