lfkit.luminosity_functions.completeness

Catalog completeness utilities for luminosity function models.

This module provides helpers for estimating the observed and missing galaxy population implied by a magnitude-limited catalog. These functions are useful for applications that need an out-of-catalog correction, such as galaxy-catalog priors for gravitational-wave cosmology.

The utilities convert an apparent magnitude limit into an absolute magnitude limit and call the generic LF integration helpers to return number densities or fractions.

The core API accepts a luminosity function callable with signature

lf(absolute_mag, z)

where absolute_mag and z are NumPy arrays that can be broadcast together. This keeps the completeness machinery independent of any specific luminosity function parameterization.

Functions

absolute_magnitude_limit(cosmo_obj, z, *, m_lim)	Return the absolute magnitude limit of an apparent magnitude catalog cut.
catalog_fraction(cosmo_obj, z, lf, *, m_lim, ...)	Return the LF fraction observable in a magnitude-limited catalog.
missing_number_density(cosmo_obj, z, lf, *, ...)	Return number density missing from a magnitude-limited catalog.
observed_number_density(cosmo_obj, z, lf, *, ...)	Return number density observable in a magnitude-limited catalog.
out_of_catalog_fraction(cosmo_obj, z, lf, *, ...)	Return the LF fraction missing from a magnitude-limited catalog.