.. _physics-stellarPopulationBroadBandLuminosities:

Stellar Population Broad Band Luminosities
==========================================

Class providing broad band luminosities of stellar populations---the flux (in :math:`L_\odot`) of a :math:`1\,\mathrm{M}_\odot` simple stellar population of given metallicity and age when convolved with a photometric filter transmission curve. These luminosities are the basic building blocks for computing galaxy apparent and absolute magnitudes in any broad-band filter system. Methods return luminosities for a specified set of filter indices at given ages and redshifts, and can also return the full luminosity track as a function of age for efficient integration over the star formation history.

**Default implementation:** ``stellarPopulationBroadBandLuminositiesStandard``

Methods
-------

``luminosities`` → ``double precision, dimension(size(luminosityIndex))``
   Returns the luminosity for a :math:`1 \mathrm{M}_\odot` simple ``stellarPopulation_`` of given ``abundances`` and ``age`` and observed through the filter specified by ``filterIndex``.

   * ``integer , intent(in ), dimension(: ) :: luminosityIndex , filterIndex``

   * ``type (stellarPopulationSpectraPostprocessorList), intent(inout), dimension(: ) :: stellarPopulationSpectraPostprocessor_``

   * ``class (stellarPopulationClass ), intent(inout) :: stellarPopulation_``

   * ``type (abundances ), intent(in ) :: abundancesStellar``

   * ``double precision , intent(in ), dimension(: ) :: age , redshift``

``luminosityTracks`` → ``void``
   Returns the luminosity for a :math:`1 \mathrm{M}_\odot` simple stellar population of given ``abundances`` drawn from the given ``stellarPopulation`` and observed through the filter specified by ``filterIndex``, for all available ages.

   * ``integer , intent(in ), dimension(: ) :: luminosityIndex , filterIndex``

   * ``type (stellarPopulationSpectraPostprocessorList), intent(inout), dimension(: ) :: stellarPopulationSpectraPostprocessor_``

   * ``class (stellarPopulationClass ), intent(inout) :: stellarPopulation_``

   * ``type (abundances ), intent(in ) :: abundancesStellar``

   * ``double precision , intent(in ), dimension(: ) :: redshift``

   * ``double precision , intent( out), dimension(: ), allocatable :: ages``

   * ``double precision , intent( out), dimension(:,:), allocatable :: luminosities``

.. _physics-stellarPopulationBroadBandLuminositiesStandard:

``stellarPopulationBroadBandLuminositiesStandard``
--------------------------------------------------

The standard stellar populations broad band luminosities class.

**(Default implementation)**

**Methods**

* ``factors`` — Compute factors needed for tidal tensor calculation.
* ``tidalTensorGet`` — Get the tidal tensor.

**Parameters**

* ``[integrationToleranceRelative]`` (real; default ``4.0d-3``) — The relative tolerance used when integrating the flux of stellar populations through filters.
* ``[integrationToleranceDegrade]`` (boolean; default ``.false.``) — If ``true``, automatically degrade the relative tolerance used when integrating the flux of stellar populations through filters to ensure convergence.
* ``[storeToFile]`` (boolean; default ``.true.``) — Specifies whether or not stellar populations luminosities (integrated under a filter) should be stored to file for rapid reuse.
* ``[storeDirectory]`` (string; default ``inputPath(pathTypeDataDynamic)//'stellarPopulations'``) — Specifies the directory to which stellar populations luminosities (integrated under a filter) should be stored to file for rapid reuse.
* ``[maximumAgeExceededIsFatal]`` (boolean; default ``.true.``) — Specifies whether or not exceeding the maximum available age of the stellar population is fatal.