sciapy.level1c

SCIAMACHY level 1c spectra module

This module contains the class for SCIAMACHY level 1c spectra. It supports limb and solar specra.

class sciapy.level1c.scia_limb_point(ls, i)[source]

Bases: object

SCIAMACHY limb tangent point data

Contains the data from a single tangent point.

Methods

from_limb_scan(ls, i) Import the spectra from a single tangent point of the limb scan
from_limb_scan(ls, i)[source]

Import the spectra from a single tangent point of the limb scan

Parameters:
  • ls (scia_limb_scan) – The SCIAMACHY limb scan from which to extract the spectra.
  • i (int) – The number of the tangent point in the limb scan
class sciapy.level1c.scia_limb_scan[source]

Bases: object

SCIAMACHY limb scan data

Contains the data from all or some selected tangent points. The format is inspired by the SCIAMACHY ascii data format.

Attributes:

  • textheader_length (int) – The number of lines of the text header.

  • textheader (str) – The header containing the limb scan meta data.

  • metadata (dict) – Metadata of the limb scan as parsed by parse_textheader(). Contains:

    datatype_txt: str

    The name of the data type.

    l1b_product: str

    The level 1b product which was calibrated.

    orbit: int

    The Envisat/SCIAMACHY orbit number.

    state_id: int

    The SCIAMACHY state_id, denotes the measurement type that was carried out, i.e. nominal limb, MLT limb, nadir, sun or moon occultation etc.

    software_version: str

    The software used for calibration.

    keyfile_version: str

    The keyfile version used in the calibration process.

    mfactor_version: str

    The M-factor version used in the calibration process.

    init_version: str

    The init version used in the calibration process.

    decont_flags: str

    The decont flags used in the calibration process.

    calibration: str

    The calibrations that were applied to the level 1b data to produce the level 1c data.

    date: str

    The measurement data of the limb scan as “%Y%m%d”

    nr_profile: int

    The number of profiles in the scan.

    act_profile: int

    The number of the current profile.

  • nalt (int) – The number of tangent points.

  • npix (int) – The number of spectral points.

  • orbit_state (tuple or list of ints) – Orbit state data containing (orbit number, state in orbit, state id, number of profiles per state (usually one), the actual profile number).

  • date (tuple or list of ints) – The limb scan’s date (year, month, day, hour, minute, second).

  • cent_lat_lon (tuple or list of float) – The centre latitude and longitude of the scan followed by the four corner latitude and longitude: (lat_centre, lon_centre, lat_corner0, lon_corner0, …, lat_corner3, lon_corner3).

  • orbit_phase (float) – The orbital phase of the limb scan.

  • wls ((N,) array_like) – The spectral wavelengths.

  • limb_data (numpy.recarray) – The limb data containing the following records:

    sub_sat_lat: (M,) array_like

    The latitudes of the satellite ground points (M = nalt).

    sub_sat_lon: (M,) array_like

    The longitudes of the satellite ground points (M = nalt).

    tp_lat: (M,) array_like

    The latitudes of the tangent points (M = nalt).

    tp_lon: (M,) array_like

    The longitudes of the tangent points (M = nalt).

    tp_alt: (M,) array_like

    The tangent altitudes (M = nalt).

    tp_sza: (M,) array_like

    The solar zenith angles at the tangent points (M = nalt).

    tp_saa: (M,) array_like

    The solar azimuth angles at the tangent points (M = nalt).

    tp_los: (M,) array_like

    The line-of-sight zenith angles at the tangent points (M = nalt).

    toa_sza: (M,) array_like

    The solar zenith angles at the top-of-atmosphere points (M = nalt).

    toa_saa: (M,) array_like

    The solar azimuth angles at the top-of-atmosphere points (M = nalt).

    toa_los: (M,) array_like

    The line-of-sight zenith angles at the top-of-atmosphere points (M = nalt).

    sat_sza: (M,) array_like

    The solar zenith angles at the satellite points (M = nalt).

    sat_saa: (M,) array_like

    The solar azimuth angles at the satellite points (M = nalt).

    sat_los: (M,) array_like

    The line-of-sight zenith angles at the satellite points (M = nalt).

    sat_alt: (M,) array_like

    The satellite altitudes (M = nalt).

    earth_rad: (M,) array_like

    The earth radii at the tangent ground points (M = nalt).

    rad: (M, N) array_like

    The radiances at the tangent points, M = nalt, N = len(wls).

    err: (M, N) array_like

    The relative radiance uncertainties at the tangent points, M = nalt, N = len(wls).

Methods

assemble_textheader() Combines the metadata to ASCII header
local_solar_time([debug]) Local solar time at limb scan footprint centre
parse_textheader() Parses the ASCII header metadata
read_from_file(filename) SCIAMACHY level 1c limb scan general file import
read_from_hdf5(hf, limb_state_id, ...) SCIAMACHY level 1c HDF main interface
read_from_mpl_binary(filename) SCIAMACHY level 1c limb scan binary import
read_from_netcdf(filename) SCIAMACHY level 1c limb scan netcdf import
read_from_textfile(filename) SCIAMACHY level 1c limb scan text import
read_hdf5_limb_state_common_data(hf, ...) SCIAMACHY level 1c common data
read_hdf5_limb_state_spectral_data(hf, ...) SCIAMACHY level 1c spectral data
write_to_mpl_binary(filename) SCIAMACHY level 1c limb scan binary export
write_to_netcdf(filename) SCIAMACHY level 1c limb scan netcdf export
write_to_textfile(filename) SCIAMACHY level 1c limb scan text export
assemble_textheader()[source]

Combines the metadata to ASCII header

Tranfers the metadata dictionary back to ASCII form for writing to disk.

local_solar_time(debug=True)[source]

Local solar time at limb scan footprint centre

Returns:(mean_lst, apparent_lst, eot_correction) –
  • mean_lst - mean local solar time
  • apparent_lst - apparent local solar time, equation of time corrected
  • eot_correction - equation of time correction in minutes
Return type:tuple
parse_textheader()[source]

Parses the ASCII header metadata

The ASCII header text contains metadata about the current limb scan. This function reads this metadata into the metadata dictionary.

read_from_file(filename)[source]

SCIAMACHY level 1c limb scan general file import

Tries netcdf first, the custom binary format second if netcdf fails, and finally ASCII import if that also fails.

read_from_hdf5(hf, limb_state_id, state_in_orbit, cluster_ids)

SCIAMACHY level 1c HDF main interface

This should be the function to be used for HDF5 reading. It reads the common data and iterates over the spectral clusters to fill the class data.

Parameters:
  • hf (opened file) – Pointer to the opened level 1c HDF5 file
  • limb_state_id (int) – The limb state id.
  • state_in_orbit (int) – The number in this batch of states for the header.
  • cluster_ids (int or sequence of ints) – The spectral cluster numbers.
Returns:

success – 0 on success, 1 if an error occurred, for example if the measurement data set for the requested limb and cluster ids is empty.
Return type:

int
read_from_mpl_binary(filename)

SCIAMACHY level 1c limb scan binary import

Parameters:filename (str) – The binary filename to read the data from.
Return type:nothing
read_from_netcdf(filename)

SCIAMACHY level 1c limb scan netcdf import

Parameters:filename (str) – The netcdf filename to read the data from.
Return type:nothing
read_from_textfile(filename)

SCIAMACHY level 1c limb scan text import

Parameters:filename (str) – The (plain ascii) table text filename to read the data from.
Return type:nothing
read_hdf5_limb_state_common_data(hf, lstate_id, state_in_orbit, cl_id)

SCIAMACHY level 1c common data

Parameters:
  • hf (opened file) – Pointer to the opened level 1c HDF5 file
  • lstate_id (int) – The limb state id.
  • state_in_orbit (int) – The number in this batch of states for the header.
  • cl_id (int) – The spectral cluster number.
Returns:

success – 0 on success, 1 if an error occurred, for example if the measurement data set for the requested limb and cluster ids is empty.
Return type:

int
read_hdf5_limb_state_spectral_data(hf, lstate_id, cl_id)

SCIAMACHY level 1c spectral data

Parameters:
  • hf (opened file) – Pointer to the opened level 1c HDF5 file
  • lstate_id (int) – The limb state id.
  • cl_id (int) – The spectral cluster number.
Returns:

success – 0 on success, 1 if an error occurred, for example if the measurement data set for the requested limb and cluster ids is empty.
Return type:

int
write_to_mpl_binary(filename)

SCIAMACHY level 1c limb scan binary export

Parameters:filename (str) – The binary filename to write the data to.
Return type:nothing
write_to_netcdf(filename)

SCIAMACHY level 1c limb scan netcdf export

Parameters:filename (str) – The netcdf filename to write the data to.
Return type:nothing
write_to_textfile(filename)

SCIAMACHY level 1c limb scan text export

Parameters:filename (str) – The (plain ascii) table text filename to write the data to.
Return type:nothing
class sciapy.level1c.scia_solar[source]

Bases: object

SCIAMACHY solar reference spectrum class

Contains the SCIAMACHY level 1c solar reference spectrum. The format is inspired by the SCIAMACHY ascii data format.

Attributes:
  • textheader_length (int) – The number of lines of the text header.
  • textheader (str) – The header containing the solar spectrum meta data.
  • npix (int) – The number of spectral points.
  • solar_id (str) – The solar reference spectrum ID, choices: “D0”, “D1”, “D2”, “E0”, “E1”, “A0”, “A1”, “N1”, “N2”, “N3”, “N4”, “N5”.
  • orbit (int) – The SCIAMACHY/Envisat orbit number.
  • time (datetime.datetime) – The sensing start time of the (semi-)orbit.
  • wls ((M,) array_like) – The spectral wavelengths.
  • rads ((M,) array_like) – The radiances at the spectral points, M = len(wls).
  • errs ((M,) array_like) – The relative radiance uncertainties at the tangent points, M = len(wls).

Methods

read_from_file(filename)[source]

SCIAMACHY level 1c solar reference data import

Convenience function to read the reference spectrum. Tries to detect the file format automatically trying netcdf first, and if that fails falls back to the text reader. Currently no HDF5 support.

Parameters:filename (str) – The filename to read from.
Return type:nothing
read_from_hdf5(hf, ref='D0')[source]

SCIAMACHY level 1c solar reference HDF5 import

Parameters:
  • hf (opened file) – Pointer to the opened level 1c HDF5 file
  • ref (str) – The solar reference spectra id name, choose from: “D0”, “D1”, “D2”, “E0”, “E1”, “A0”, “A1”, “N1”, “N2”, “N3”, “N4”, “N5”. Defaults to “D0”.
Returns:

success – 0 on success, 1 if an error occured.
Return type:

int
read_from_netcdf(filename)[source]

SCIAMACHY level 1c solar reference netcdf import

Parameters:filename (str) – The netcdf filename to read the data from.
Return type:nothing
read_from_textfile(filename)[source]

SCIAMACHY level 1c solar reference text import

Parameters:filename (str) – The (plain) ascii table filename to read the data from.
Return type:nothing
write_to_netcdf(filename)[source]

SCIAMACHY level 1c solar reference netcdf export

Parameters:filename (str) – The netcdf filename to write the data to.
Return type:nothing
write_to_textfile(filename)[source]

SCIAMACHY level 1c solar reference text export

Parameters:filename (str) – The (plain) ascii table filename to write the data to. Passing sys.STDOUT writes to the console.
Return type:nothing

sciapy.level1c.scia_limb

SCIAMACHY level 1c limb spectra module

This module contains the class for SCIAMACHY level 1c limb spectra. It include some simple conversion routines: from and to ascii, from and to binary, from and to netcdf.

A simple import from HDF5 files produced by the SRON nadc_tools (https://github.com/rmvanhees/nadc_tools) is also supported.

class sciapy.level1c.scia_limb.scia_limb_point(ls, i)[source]

Bases: object

SCIAMACHY limb tangent point data

Contains the data from a single tangent point.

Methods

from_limb_scan(ls, i) Import the spectra from a single tangent point of the limb scan
from_limb_scan(ls, i)[source]

Import the spectra from a single tangent point of the limb scan

Parameters:
  • ls (scia_limb_scan) – The SCIAMACHY limb scan from which to extract the spectra.
  • i (int) – The number of the tangent point in the limb scan
class sciapy.level1c.scia_limb.scia_limb_scan[source]

Bases: object

SCIAMACHY limb scan data

Contains the data from all or some selected tangent points. The format is inspired by the SCIAMACHY ascii data format.

Attributes:

  • textheader_length (int) – The number of lines of the text header.

  • textheader (str) – The header containing the limb scan meta data.

  • metadata (dict) – Metadata of the limb scan as parsed by parse_textheader(). Contains:

    datatype_txt: str

    The name of the data type.

    l1b_product: str

    The level 1b product which was calibrated.

    orbit: int

    The Envisat/SCIAMACHY orbit number.

    state_id: int

    The SCIAMACHY state_id, denotes the measurement type that was carried out, i.e. nominal limb, MLT limb, nadir, sun or moon occultation etc.

    software_version: str

    The software used for calibration.

    keyfile_version: str

    The keyfile version used in the calibration process.

    mfactor_version: str

    The M-factor version used in the calibration process.

    init_version: str

    The init version used in the calibration process.

    decont_flags: str

    The decont flags used in the calibration process.

    calibration: str

    The calibrations that were applied to the level 1b data to produce the level 1c data.

    date: str

    The measurement data of the limb scan as “%Y%m%d”

    nr_profile: int

    The number of profiles in the scan.

    act_profile: int

    The number of the current profile.

  • nalt (int) – The number of tangent points.

  • npix (int) – The number of spectral points.

  • orbit_state (tuple or list of ints) – Orbit state data containing (orbit number, state in orbit, state id, number of profiles per state (usually one), the actual profile number).

  • date (tuple or list of ints) – The limb scan’s date (year, month, day, hour, minute, second).

  • cent_lat_lon (tuple or list of float) – The centre latitude and longitude of the scan followed by the four corner latitude and longitude: (lat_centre, lon_centre, lat_corner0, lon_corner0, …, lat_corner3, lon_corner3).

  • orbit_phase (float) – The orbital phase of the limb scan.

  • wls ((N,) array_like) – The spectral wavelengths.

  • limb_data (numpy.recarray) – The limb data containing the following records:

    sub_sat_lat: (M,) array_like

    The latitudes of the satellite ground points (M = nalt).

    sub_sat_lon: (M,) array_like

    The longitudes of the satellite ground points (M = nalt).

    tp_lat: (M,) array_like

    The latitudes of the tangent points (M = nalt).

    tp_lon: (M,) array_like

    The longitudes of the tangent points (M = nalt).

    tp_alt: (M,) array_like

    The tangent altitudes (M = nalt).

    tp_sza: (M,) array_like

    The solar zenith angles at the tangent points (M = nalt).

    tp_saa: (M,) array_like

    The solar azimuth angles at the tangent points (M = nalt).

    tp_los: (M,) array_like

    The line-of-sight zenith angles at the tangent points (M = nalt).

    toa_sza: (M,) array_like

    The solar zenith angles at the top-of-atmosphere points (M = nalt).

    toa_saa: (M,) array_like

    The solar azimuth angles at the top-of-atmosphere points (M = nalt).

    toa_los: (M,) array_like

    The line-of-sight zenith angles at the top-of-atmosphere points (M = nalt).

    sat_sza: (M,) array_like

    The solar zenith angles at the satellite points (M = nalt).

    sat_saa: (M,) array_like

    The solar azimuth angles at the satellite points (M = nalt).

    sat_los: (M,) array_like

    The line-of-sight zenith angles at the satellite points (M = nalt).

    sat_alt: (M,) array_like

    The satellite altitudes (M = nalt).

    earth_rad: (M,) array_like

    The earth radii at the tangent ground points (M = nalt).

    rad: (M, N) array_like

    The radiances at the tangent points, M = nalt, N = len(wls).

    err: (M, N) array_like

    The relative radiance uncertainties at the tangent points, M = nalt, N = len(wls).

Methods

assemble_textheader() Combines the metadata to ASCII header
local_solar_time([debug]) Local solar time at limb scan footprint centre
parse_textheader() Parses the ASCII header metadata
read_from_file(filename) SCIAMACHY level 1c limb scan general file import
read_from_hdf5(hf, limb_state_id, ...) SCIAMACHY level 1c HDF main interface
read_from_mpl_binary(filename) SCIAMACHY level 1c limb scan binary import
read_from_netcdf(filename) SCIAMACHY level 1c limb scan netcdf import
read_from_textfile(filename) SCIAMACHY level 1c limb scan text import
read_hdf5_limb_state_common_data(hf, ...) SCIAMACHY level 1c common data
read_hdf5_limb_state_spectral_data(hf, ...) SCIAMACHY level 1c spectral data
write_to_mpl_binary(filename) SCIAMACHY level 1c limb scan binary export
write_to_netcdf(filename) SCIAMACHY level 1c limb scan netcdf export
write_to_textfile(filename) SCIAMACHY level 1c limb scan text export
assemble_textheader()[source]

Combines the metadata to ASCII header

Tranfers the metadata dictionary back to ASCII form for writing to disk.

local_solar_time(debug=True)[source]

Local solar time at limb scan footprint centre

Returns:(mean_lst, apparent_lst, eot_correction) –
  • mean_lst - mean local solar time
  • apparent_lst - apparent local solar time, equation of time corrected
  • eot_correction - equation of time correction in minutes
Return type:tuple
parse_textheader()[source]

Parses the ASCII header metadata

The ASCII header text contains metadata about the current limb scan. This function reads this metadata into the metadata dictionary.

read_from_file(filename)[source]

SCIAMACHY level 1c limb scan general file import

Tries netcdf first, the custom binary format second if netcdf fails, and finally ASCII import if that also fails.

read_from_hdf5(hf, limb_state_id, state_in_orbit, cluster_ids)

SCIAMACHY level 1c HDF main interface

This should be the function to be used for HDF5 reading. It reads the common data and iterates over the spectral clusters to fill the class data.

Parameters:
  • hf (opened file) – Pointer to the opened level 1c HDF5 file
  • limb_state_id (int) – The limb state id.
  • state_in_orbit (int) – The number in this batch of states for the header.
  • cluster_ids (int or sequence of ints) – The spectral cluster numbers.
Returns:

success – 0 on success, 1 if an error occurred, for example if the measurement data set for the requested limb and cluster ids is empty.
Return type:

int
read_from_mpl_binary(filename)

SCIAMACHY level 1c limb scan binary import

Parameters:filename (str) – The binary filename to read the data from.
Return type:nothing
read_from_netcdf(filename)

SCIAMACHY level 1c limb scan netcdf import

Parameters:filename (str) – The netcdf filename to read the data from.
Return type:nothing
read_from_textfile(filename)

SCIAMACHY level 1c limb scan text import

Parameters:filename (str) – The (plain ascii) table text filename to read the data from.
Return type:nothing
read_hdf5_limb_state_common_data(hf, lstate_id, state_in_orbit, cl_id)

SCIAMACHY level 1c common data

Parameters:
  • hf (opened file) – Pointer to the opened level 1c HDF5 file
  • lstate_id (int) – The limb state id.
  • state_in_orbit (int) – The number in this batch of states for the header.
  • cl_id (int) – The spectral cluster number.
Returns:

success – 0 on success, 1 if an error occurred, for example if the measurement data set for the requested limb and cluster ids is empty.
Return type:

int
read_hdf5_limb_state_spectral_data(hf, lstate_id, cl_id)

SCIAMACHY level 1c spectral data

Parameters:
  • hf (opened file) – Pointer to the opened level 1c HDF5 file
  • lstate_id (int) – The limb state id.
  • cl_id (int) – The spectral cluster number.
Returns:

success – 0 on success, 1 if an error occurred, for example if the measurement data set for the requested limb and cluster ids is empty.
Return type:

int
write_to_mpl_binary(filename)

SCIAMACHY level 1c limb scan binary export

Parameters:filename (str) – The binary filename to write the data to.
Return type:nothing
write_to_netcdf(filename)

SCIAMACHY level 1c limb scan netcdf export

Parameters:filename (str) – The netcdf filename to write the data to.
Return type:nothing
write_to_textfile(filename)

SCIAMACHY level 1c limb scan text export

Parameters:filename (str) – The (plain ascii) table text filename to write the data to.
Return type:nothing

sciapy.level1c.scia_limb_hdf5

SCIAMACHY level 1c limb spectra hdf5 interface

sciapy.level1c.scia_limb_hdf5.read_from_hdf5(self, hf, limb_state_id, state_in_orbit, cluster_ids)[source]

SCIAMACHY level 1c HDF main interface

This should be the function to be used for HDF5 reading. It reads the common data and iterates over the spectral clusters to fill the class data.

Parameters:
  • hf (opened file) – Pointer to the opened level 1c HDF5 file
  • limb_state_id (int) – The limb state id.
  • state_in_orbit (int) – The number in this batch of states for the header.
  • cluster_ids (int or sequence of ints) – The spectral cluster numbers.
Returns:

success – 0 on success, 1 if an error occurred, for example if the measurement data set for the requested limb and cluster ids is empty.
Return type:

int
sciapy.level1c.scia_limb_hdf5.read_hdf5_limb_state_common_data(self, hf, lstate_id, state_in_orbit, cl_id)[source]

SCIAMACHY level 1c common data

Parameters:
  • hf (opened file) – Pointer to the opened level 1c HDF5 file
  • lstate_id (int) – The limb state id.
  • state_in_orbit (int) – The number in this batch of states for the header.
  • cl_id (int) – The spectral cluster number.
Returns:

success – 0 on success, 1 if an error occurred, for example if the measurement data set for the requested limb and cluster ids is empty.
Return type:

int
sciapy.level1c.scia_limb_hdf5.read_hdf5_limb_state_spectral_data(self, hf, lstate_id, cl_id)[source]

SCIAMACHY level 1c spectral data

Parameters:
  • hf (opened file) – Pointer to the opened level 1c HDF5 file
  • lstate_id (int) – The limb state id.
  • cl_id (int) – The spectral cluster number.
Returns:

success – 0 on success, 1 if an error occurred, for example if the measurement data set for the requested limb and cluster ids is empty.
Return type:

int

sciapy.level1c.scia_limb_mpl

SCIAMACHY level 1c limb spectra binary interface

sciapy.level1c.scia_limb_mpl.read_from_mpl_binary(self, filename)[source]

SCIAMACHY level 1c limb scan binary import

Parameters:filename (str) – The binary filename to read the data from.
Return type:nothing
sciapy.level1c.scia_limb_mpl.write_to_mpl_binary(self, filename)[source]

SCIAMACHY level 1c limb scan binary export

Parameters:filename (str) – The binary filename to write the data to.
Return type:nothing

sciapy.level1c.scia_limb_nc

SCIAMACHY level 1c limb spectra netcdf interface

sciapy.level1c.scia_limb_nc.read_from_netcdf(self, filename)[source]

SCIAMACHY level 1c limb scan netcdf import

Parameters:filename (str) – The netcdf filename to read the data from.
Return type:nothing
sciapy.level1c.scia_limb_nc.write_to_netcdf(self, filename)[source]

SCIAMACHY level 1c limb scan netcdf export

Parameters:filename (str) – The netcdf filename to write the data to.
Return type:nothing

sciapy.level1c.scia_limb_txt

SCIAMACHY level 1c limb spectra text interface

sciapy.level1c.scia_limb_txt.read_from_textfile(self, filename)[source]

SCIAMACHY level 1c limb scan text import

Parameters:filename (str) – The (plain ascii) table text filename to read the data from.
Return type:nothing
sciapy.level1c.scia_limb_txt.write_to_textfile(self, filename)[source]

SCIAMACHY level 1c limb scan text export

Parameters:filename (str) – The (plain ascii) table text filename to write the data to.
Return type:nothing

sciapy.level1c.scia_solar

SCIAMACHY level 1c solar spectra module

This module contains the python class for SCIAMACHY level 1c solar spectra. It include some simple conversion routines, from and to ascii and from and to netcdf.

A simple import from SRON nadc_tools (https://github.com/rmvanhees/nadc_tools) produced HDF5 is also supported.

class sciapy.level1c.scia_solar.scia_solar[source]

Bases: object

SCIAMACHY solar reference spectrum class

Contains the SCIAMACHY level 1c solar reference spectrum. The format is inspired by the SCIAMACHY ascii data format.

Attributes:
  • textheader_length (int) – The number of lines of the text header.
  • textheader (str) – The header containing the solar spectrum meta data.
  • npix (int) – The number of spectral points.
  • solar_id (str) – The solar reference spectrum ID, choices: “D0”, “D1”, “D2”, “E0”, “E1”, “A0”, “A1”, “N1”, “N2”, “N3”, “N4”, “N5”.
  • orbit (int) – The SCIAMACHY/Envisat orbit number.
  • time (datetime.datetime) – The sensing start time of the (semi-)orbit.
  • wls ((M,) array_like) – The spectral wavelengths.
  • rads ((M,) array_like) – The radiances at the spectral points, M = len(wls).
  • errs ((M,) array_like) – The relative radiance uncertainties at the tangent points, M = len(wls).

Methods

read_from_file(filename) SCIAMACHY level 1c solar reference data import
read_from_hdf5(hf[, ref]) SCIAMACHY level 1c solar reference HDF5 import
read_from_netcdf(filename) SCIAMACHY level 1c solar reference netcdf import
read_from_textfile(filename) SCIAMACHY level 1c solar reference text import
write_to_netcdf(filename) SCIAMACHY level 1c solar reference netcdf export
write_to_textfile(filename) SCIAMACHY level 1c solar reference text export
read_from_file(filename)[source]

SCIAMACHY level 1c solar reference data import

Convenience function to read the reference spectrum. Tries to detect the file format automatically trying netcdf first, and if that fails falls back to the text reader. Currently no HDF5 support.

Parameters:filename (str) – The filename to read from.
Return type:nothing
read_from_hdf5(hf, ref='D0')[source]

SCIAMACHY level 1c solar reference HDF5 import

Parameters:
  • hf (opened file) – Pointer to the opened level 1c HDF5 file
  • ref (str) – The solar reference spectra id name, choose from: “D0”, “D1”, “D2”, “E0”, “E1”, “A0”, “A1”, “N1”, “N2”, “N3”, “N4”, “N5”. Defaults to “D0”.
Returns:

success – 0 on success, 1 if an error occured.
Return type:

int
read_from_netcdf(filename)[source]

SCIAMACHY level 1c solar reference netcdf import

Parameters:filename (str) – The netcdf filename to read the data from.
Return type:nothing
read_from_textfile(filename)[source]

SCIAMACHY level 1c solar reference text import

Parameters:filename (str) – The (plain) ascii table filename to read the data from.
Return type:nothing
write_to_netcdf(filename)[source]

SCIAMACHY level 1c solar reference netcdf export

Parameters:filename (str) – The netcdf filename to write the data to.
Return type:nothing
write_to_textfile(filename)[source]

SCIAMACHY level 1c solar reference text export

Parameters:filename (str) – The (plain) ascii table filename to write the data to. Passing sys.STDOUT writes to the console.
Return type:nothing