owls
================================================

Apply baryonic feedback effects to matter power spectrum using OWLS simulations

+-------------+------------------------------------------+
| File        | structure/owls/owls_interface.py         |
+-------------+------------------------------------------+
| Attribution | CosmoSIS Team                            |
+-------------+------------------------------------------+
|             | VIRGO Consortium                         |
+-------------+------------------------------------------+
| URL         | https://virgo.dur.ac.uk/2010/02/12/OWLS/ |
+-------------+------------------------------------------+
| Citations   | Baryon boosts from OWLS simulations      |
+-------------+------------------------------------------+

This module applies baryonic feedback effects to the nonlinear matter
power spectrum using the OWLS (OverWhelmingly Large Simulations) suite
of hydrodynamical simulations.

The module supports several modes:
- 'single': Single parameter OWLS_R controlling feedback strength
- 'chebyshev': Multiple Chebyshev coefficients for k and z dependence
- 'fixed': Fixed feedback from specific OWLS simulation
- 'scaled': Scaled version of fixed OWLS simulation

The feedback modulation is applied as a multiplicative factor to the
matter power spectrum.


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

 - OWLS simulation results can be interpolated to desired cosmology
 - Baryonic effects modify only the matter power spectrum



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

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

   * - Name
     - Type
     - Default
     - Description

   * - mode
     - str
     - single
     - OWLS mode ('single', 'chebyshev', 'fixed', or 'scaled')
   * - nterm
     - int
     - 
     - Number of Chebyshev terms (required for chebyshev mode)
   * - powtable
     - str
     - 
     - Path to OWLS power table file (required for fixed/scaled modes)


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

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

   * - Section
     - Name
     - Type
     - Default
     - Description

   * - OWLS
     - R
     - real
     - 
     - OWLS feedback parameter (for single/scaled modes)
   * - 
     - K{i}
     - real
     - 
     - Chebyshev coefficient for k-dependence (K1, K2, ... for chebyshev mode)
   * - 
     - Z{i}
     - real
     - 
     - Chebyshev coefficient for z-dependence (Z1, Z2, ... for chebyshev mode)
   * - matter_power_nl
     - k_h
     - real 1d
     - 
     - Wavenumber values in h/Mpc
   * - 
     - z
     - real 1d
     - 
     - Redshift values
   * - 
     - p_k
     - real 2d
     - 
     - Nonlinear matter power spectrum to be modified


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


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

   * - Section
     - Name
     - Type
     - Description

   * - matter_power_nl
     - k_h
     - real 1d
     - Wavenumber values in h/Mpc
   * - 
     - z
     - real 1d
     - Redshift values
   * - 
     - p_k
     - real 2d
     - Baryonic feedback-modified matter power spectrum