aerosoltools.loaders.Load_NS_file

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

Load and process NanoScan SMPS data exported in CSV format.

This function reads NanoScan data, extracts time-resolved size distributions, computes bin edges and midpoints, and parses metadata including density and unit type.

Parameters

filestr

Path to the NanoScan CSV export file.

extra_databool, optional

If True, retains all non-distribution columns in the .extra_data attribute. Default is False.

Returns

NSAerosol2D

Aerosol2D object containing: - Time-indexed size distribution and total concentration data - Instrument metadata (e.g., bin edges, serial number, density, unit)

Raises

Exception

If the unit format or data type is unrecognized.

Notes

  • Bin midpoints are extracted from column headers.

  • Bin edges are estimated using geometric means between bin midpoints.

  • Size distribution columns are assumed to span from column 1 to 13 (inclusive).

Parameters:

  • file (str)

  • extra_data (bool)

Return type:

Aerosol2D