fiducial_cl
================================================

Replace CMB power spectra with fiducial values from data files

+-------------+----------------------------------------+
| File        | cmb_lensing/fiducial_cl/fiducial_cl.py |
+-------------+----------------------------------------+
| Attribution | CosmoSIS Team                          |
+-------------+----------------------------------------+
| URL         |                                        |
+-------------+----------------------------------------+

This module replaces computed CMB power spectra with fiducial values
loaded from data files. This is useful for testing or when you want
to use specific reference power spectra instead of computed ones.

The module loads TT, TE, EE, BB, and optionally PP (lensing) power spectra
from files and replaces the first part of the computed spectra with these
fiducial values. The rest can optionally be zeroed out.


Assumptions
-----------

 - Fiducial CMB power spectra are provided as external data files



Setup Parameters
----------------

.. list-table::
   :header-rows: 1

   * - Name
     - Type
     - Default
     - Description

   * - data_dir
     - str
     - data/
     - Directory containing fiducial power spectra files (should contain clTT.txt, clTE.txt, etc.)
   * - replace_pp
     - bool
     - False
     - Whether to also replace the lensing potential power spectrum
   * - zero_remainder
     - bool
     - False
     - Whether to zero out spectra beyond the fiducial range


Input values
----------------

.. list-table::
   :header-rows: 1

   * - Section
     - Name
     - Type
     - Default
     - Description

   * - cmb_cl
     - TT
     - real 1d
     - 
     - Temperature power spectrum to be replaced
   * - 
     - TE
     - real 1d
     - 
     - Temperature-E-mode cross power spectrum to be replaced
   * - 
     - EE
     - real 1d
     - 
     - E-mode power spectrum to be replaced
   * - 
     - BB
     - real 1d
     - 
     - B-mode power spectrum to be replaced
   * - 
     - PP
     - real 1d
     - 
     - Lensing potential power spectrum to be replaced (if replace_pp=true)


Output values
----------------


.. list-table:: Output values
   :header-rows: 1

   * - Section
     - Name
     - Type
     - Description

   * - cmb_cl
     - TT
     - real 1d
     - Modified temperature power spectrum with fiducial values
   * - 
     - TE
     - real 1d
     - Modified temperature-E-mode cross power spectrum
   * - 
     - EE
     - real 1d
     - Modified E-mode power spectrum with fiducial values
   * - 
     - BB
     - real 1d
     - Modified B-mode power spectrum with fiducial values
   * - 
     - PP
     - real 1d
     - Modified lensing potential power spectrum (if replace_pp=true)