aerosoltools.loaders.Load_ELPI_file — aerosoltools 0.1.0 documentation

# aerosoltools.loaders.Load_ELPI_file

aerosoltools.loaders.Load_ELPI_file(file, extra_data=False)

  Load data from an ELPI (.txt) file and convert it into an Aerosol2D object.

  This function reads ELPI exports (usually .txt files), extracts datetime and particle size distribution information, applies unit conversions (e.g., from dW/dlogDp), and calculates total concentration and size-resolved particle data in cm⁻³.

  ## Parameters

  filestr

    Path to the ELPI-exported .dat file.

  extra_databool, optional

    If True, retains and returns all non-distribution data in .extra_data. Default is False.

  ## Returns

  ELPIAerosol2D

    Object containing parsed size distribution data, total concentration, and instrument metadata.

  ## Raises

  Exception

    If unit or weight format cannot be determined, or parsing fails.

  ## Notes

  - Bin mids and edges are stored in nanometers.

  - Normalization is done to convert to number concentration dN.

  - Supports dynamic density-aware edge recomputation when density ≠ 1.

  Parameters:

    - file (str)

    - extra_data (bool)