py21cmfast.drivers.Coeval
=========================

.. py:class:: py21cmfast.drivers.Coeval

   
   A full coeval box with all associated data.
















   ..
       !! processed by numpydoc !!

   .. py:method:: __eq__(other)

      
      Determine if this is equal to another object.
















      ..
          !! processed by numpydoc !!


   .. py:method:: __getattr__(name)

      
      Get underlying Array objects as attributes.

      This method allows accessing arrays from OutputStruct objects within the Coeval instance
      as if they were direct attributes of the Coeval object.

      :Parameters: **name** (*str*) -- The name of the attribute being accessed.

      :returns: *Any* -- The value of the requested array from the appropriate OutputStruct object.

      :raises AttributeError: If the requested attribute is not found in any of the OutputStruct objects.















      ..
          !! processed by numpydoc !!


   .. py:method:: apply_rsds(field = 'brightness_temp', axis = 'z', periodic = True, n_rsd_subcells = 4)

      
      Apply redshift-space distortions to a particular field of the coeval box.

      :Parameters: * **field** (*str, optional*) -- The field onto which redshift-space distortions shall be applied. Default is "brightness_temp".
                   * **axis** (*str, optioanl*) -- The assumed axis of the line-of-sight. Options are "x", "y", or "z". Default is "z".
                   * **periodic** (*bool, optioanl*) -- Whether to assume periodic boundary conditions along the line-of-sight. Default is True.
                   * **n_rsd_subcells** (*int, optional*) -- The number of subcells into which each cell is divided when redshift space distortions are applied. Default is 4.

      :returns: *field_with_rsds* -- A box of the field, with redshift space distortions.















      ..
          !! processed by numpydoc !!


   .. py:method:: apply_velocity_corrections(axis = 'z', periodic = True, n_rsd_subcells = 4)

      
      Apply velocity gradient corrections and redshift-space distortions to the brightness temperature field.

      :Parameters: * **axis** (*str, optioanl*) -- The assumed axis of the line-of-sight. Options are "x", "y", or "z". Default is "z".
                   * **periodic** (*bool, optioanl*) -- Whether to assume periodic boundary conditions along the line-of-sight. Default is True.
                   * **n_rsd_subcells** (*int, optional*) -- The number of subcells into which each cell is divided when redshift space distortions are applied. Default is 4.

      :returns: *field_with_rsds* -- A box of the brightness temperature, with velocity gradient corrections and redshift-space distortions.















      ..
          !! processed by numpydoc !!


   .. py:method:: from_file(path, safe = True)
      :classmethod:


      
      Read the Coeval object from disk and return it.
















      ..
          !! processed by numpydoc !!


   .. py:method:: get_fields(ignore_structs = ())
      :classmethod:


      
      Obtain a list of name of simulation boxes saved in the Coeval object.
















      ..
          !! processed by numpydoc !!


   .. py:method:: include_dvdr_in_tau21(axis = 'z', periodic = True)

      
      Include velocity gradient corrections to the brightness temperature field.

      :Parameters: * **axis** (*str, optioanl*) -- The assumed axis of the line-of-sight. Options are "x", "y", or "z". Default is "z".
                   * **periodic** (*bool, optioanl*) -- Whether to assume periodic boundary conditions along the line-of-sight. Default is True.

      :returns: *tb_with_dvdr* -- A box of the brightness temperature, with velocity gradient corrections.















      ..
          !! processed by numpydoc !!


   .. py:method:: save(path, clobber=False)

      
      Save the Coeval object to disk.
















      ..
          !! processed by numpydoc !!


   .. py:property:: astro_options

      
      Flag Options shared by all datasets.
















      ..
          !! processed by numpydoc !!


   .. py:property:: astro_params

      
      Astro params shared by all datasets.
















      ..
          !! processed by numpydoc !!


   .. py:attribute:: brightness_temperature
      :type:  py21cmfast.wrapper.outputs.BrightnessTemp


   .. py:property:: cosmo_params

      
      Cosmo params shared by all datasets.
















      ..
          !! processed by numpydoc !!


   .. py:attribute:: halobox
      :type:  py21cmfast.wrapper.outputs.HaloBox


   .. py:attribute:: initial_conditions
      :type:  py21cmfast.wrapper.outputs.InitialConditions


   .. py:property:: inputs
      :type: py21cmfast.wrapper.inputs.InputParameters


      
      An InputParameters object associated with the coeval box.
















      ..
          !! processed by numpydoc !!


   .. py:attribute:: ionized_box
      :type:  py21cmfast.wrapper.outputs.IonizedBox


   .. py:property:: matter_options

      
      Matter Flags shared by all datasets.
















      ..
          !! processed by numpydoc !!


   .. py:property:: output_structs
      :type: dict[str, py21cmfast.wrapper.outputs.OutputStruct]


      
      Get a dictionary of OutputStruct objects contained in this Coeval instance.

      This property method returns a dictionary containing all the OutputStruct
      objects that are attributes of the Coeval instance. It filters out any
      non-OutputStruct attributes.

      :returns: *dict[str, OutputStruct]* -- A dictionary where the keys are attribute names and the values are
                the corresponding OutputStruct objects.















      ..
          !! processed by numpydoc !!


   .. py:attribute:: perturbed_field
      :type:  py21cmfast.wrapper.outputs.PerturbedField


   .. py:attribute:: photon_nonconservation_data
      :type:  dict


   .. py:property:: random_seed

      
      Random seed shared by all datasets.
















      ..
          !! processed by numpydoc !!


   .. py:property:: redshift
      :type: float


      
      The redshift of the coeval box.
















      ..
          !! processed by numpydoc !!


   .. py:property:: simulation_options

      
      Matter Params shared by all datasets.
















      ..
          !! processed by numpydoc !!


   .. py:attribute:: ts_box
      :type:  py21cmfast.wrapper.outputs.TsBox