edges.cal.input_sources

Definition of a class that contains all the data required for a calibration load.

class edges.cal.input_sources.InputSource(*, spectrum: LoadSpectrum, reflection_coefficient: ReflectionCoefficient, raw_s11: ReflectionCoefficient | None = None, ambient_temperature: ArrayLike | Quantity | None = <Quantity 298. K>, name='', loss: ArrayLike | Quantity | None = NOTHING)[source]

Class containing all relevant information for a given calibration source.

Parameters:

  • spectrum (edges.cal.spectra.LoadSpectrum) – The spectrum for this input source.

  • reflection_coefficient (edges.cal.sparams.core.datatypes.ReflectionCoefficient) – The calibrated reflection coefficient for this input source, defined at the frequencies of the spectrum.

  • raw_s11 – The un-modeled reflection coefficient, which can be set simply to be able to compare to the modeled coefficients.

  • ambient_temperature (astropy.units.quantity.Quantity) – The ambient temperature when the spectra were taken. Used only when calculating the loss.

  • name (str) – The name of the input source. Optional, but can be useful if set.

  • loss (numpy.ndarray) – The loss as a function of frequency (must have the same size as the number of frequency channels in the spectrum).

property averaged_q: ndarray

The average spectrum power ratio, Q (over time).

property freqs: Annotated[Quantity, PhysicalType('frequency')]

Frequencies of the spectrum.

classmethod from_caldef(caldef: CalObsDefEDGES2 | CalObsDefEDGES3, load_name: str, internal_switch: SParams | None = None, ambient_temperature: Quantity, PhysicalType('temperature')] | None=None, f_low: Quantity, PhysicalType('frequency')]=<Quantity 40. MHz>, f_high: Quantity, PhysicalType('frequency')]=<Quantity inf MHz>, s11_kwargs: dict | None = None, spec_kwargs: dict | None = None, loss_model: Callable | None = None, loss_model_params: S11ModelParams = S11ModelParams(model=Fourier(parameters=None, n_terms=27, _transform=ZerotooneTransform(range=(0.0, 1.0)), xtransform=ZerotooneTransform(range=(0.0, 1.0)), basis_scaler=None, data_transform=IdentityTransform(), period=1.5), complex_model_type=<class 'edges.modeling.composite.ComplexRealImagModel'>, find_model_delay=False, model_delay=<Quantity 0. s>, set_transform_range=True, fit_method='lstsq', combine_s12s21=True), restrict_s11_freqs: bool = False) → Self[source]

Define a full InputSource from a path and name.

Parameters:

  • caldef – The calibration definition object that points to all the required datafiles.

  • load_name – The name of the load within the calibration definition to use.

  • internal_switch – The internal switch S-parameters to calibrate the source reflection coefficient (optional – use for EDGES 2). Note tat you can compute this with get_internal_switch_from_caldef().

  • ambient_temperature – The ambient temperature during the spectrum observations.

  • f_low – The minimum frequency to keep in the spectra.

  • f_high – The maximum frequency to keep in the spectra.

  • s11_kwargs – Keyword arguments affecting how the reflection coefficients are calibrated and modelled.

  • spec_kwargs – Keyword arguments affecting how the spectra are defined.

  • loss_model – A callable model of the loss of the source.

  • restrict_s11_freqs – Whether to restrict the S11 frequencies to f_low/f_high when calibrating and modelling (they will always be restricted to the spectrum frequencies after modelling).

Returns:

load – The InputSource object, containing all info about spectra and S11’s for that input source.

classmethod from_file(path: str | Path | Group)

Load an HDF5 file as a given type.

get_temp_with_loss()[source]

Calculate the temperature of the load accounting for loss.

property s11: ReflectionCoefficient

An alias for the reflection coefficient.

write(path: str | Path | Group)

Write an attrs class to HDF5.