imap_processing.codice.codice_l2.compute_geometric_factors

imap_processing.codice.codice_l2.compute_geometric_factors(dataset: Dataset) → ndarray

Calculate geometric factors needed for intensity calculations.

Geometric factors are determined by comparing the half-spin values per esa_step in the HALF_SPIN_LUT to the rgfo_half_spin values in the provided L2 dataset.

If the half-spin value is less than the corresponding rgfo_half_spin value, the geometric factor is set to 0.75 (full mode); otherwise, it is set to 0.5 (reduced mode).

NOTE: Half spin values are associated with ESA steps which corresponds to the index of the energy_per_charge dimension that is between 0 and 127.

Parameters:

dataset (xarray.Dataset) – The L2 dataset containing rgfo_half_spin data variable.

Returns:

geometric_factors – A 2D array of geometric factors with shape (epoch, esa_steps).

Return type:

np.ndarray