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)