aerosoltools.loaders.Load_NS_file — aerosoltools 0.1.0 documentation

# 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