fitsmgmt.io.load_ccds

fitsmgmt.io.load_ccds(
    paths,
    extension=None,
    trimsec=None,
    ccddata=True,
    use_wcs=True,
    unit=None,
    extension_uncertainty='UNCERT',
    extension_mask='MASK',
    extension_flags=None,
    full=False,
    key_uncertainty_type='UTYPE',
    memmap=False,
    **kwd,
)

Load multiple FITS files with load_ccd.

Parameters

paths : path-like or sequence of path-like

A file path, glob pattern, or sequence of paths and glob patterns.

extension : HDUExt = None

trimsec : HDUExt = None

ccddata : HDUExt = None

use_wcs : HDUExt = None

unit : HDUExt = None

extension_uncertainty : HDUExt = None

extension_mask : str | None = 'MASK'

Passed unchanged to load_ccd for every resolved path.

extension_flags : str | None = 'MASK'

Passed unchanged to load_ccd for every resolved path.

full : str | None = 'MASK'

Passed unchanged to load_ccd for every resolved path.

key_uncertainty_type : str | None = 'MASK'

Passed unchanged to load_ccd for every resolved path.

memmap : str | None = 'MASK'

Passed unchanged to load_ccd for every resolved path.

****kwd** : = {}

Additional keywords passed to load_ccd.

Returns

: list

One result from load_ccd per resolved path. Paths are expanded and sorted by inputs2list before loading.

Historical timing records

These measurements are retained for comparison only; they are not performance contracts.

Timing on MBP 14” [2021, macOS 12.2, M1Pro(6P+2E/G16c/N16c/32G)] using 10 FITS (each 4.3 MB) with ~ 100 header cards:

%timeit ccds = air.load_ccds("h_20191021_000*")
105 ms +- 2.11 ms per loop (mean +- std. dev. of 7 runs, 10 loops each)

Timing on MBP 14” [2024, macOS 26.4.1, M4Pro(8P+4E/G20c/N16c/48G)], 2026-05-27, using 10 FITS files (each 4.2 MB):

%timeit air.load_ccds(pattern)
# 11.0 ms ± 603 µs per loop (5 runs, 2 loops each)
%timeit air.load_ccds(
...     pattern,
...     use_wcs=False,
...     extension_uncertainty=None,
...     extension_mask=None,
... )
# 6.52 ms ± 247 µs per loop (7 runs, 3 loops each)