aeronet_tools

cimel_aod_provider

class aeronet_tools.cimel_aod_provider.AodProvider(datapath, location='Munich', level=15)[source]

Provides optical thickness from AERONET database <= version 2

AERONET homepage: https://aeronet.gsfc.nasa.gov/cgi-bin/webtool_opera_v2_new

Parameters:
  • datapath (str) – path to AERONET data
  • location (str) – AERONET site. Default “Munich”
  • level (int) – processing level. Default 15 (represents level 1.5)
get_aod_and_var(request_wvl)[source]

Get aerosol optical thickness for a certain wavelength and aod variability at 500 nm

Parameters:request_wvl (float or array) – wavelength in [nm]
Returns:times: array
Return type:POSIX
Returns:aod: array
Return type:float
Returns:aod_var_500: array
Return type:float
get_aods_day(request_ts, request_wvl)[source]

Get aerosol optical thickness for a whole day and certain wavelength(s)

Parameters:
  • request_ts (datetime) – time stamp of requested day
  • request_wvl (float or array) – requested wavelength(s) in [nm]
Returns:

dt_times: time array of requested day
Return type:

datetime
Returns:

aod: aerosol optical thickness array of requested day and wavelength(s)
Return type:

float
Returns:

aod_var_500: aod variability array at 500 nm for requested day
Return type:

float
get_od(request_wvl)[source]

Get total optical thickness and components

Parameters:wvl (float) – wavelength in [nm]
Returns:od_dict_tot: dictionary (total OD, aerosol, Rayleigh, O3, NO2, CO2, CH4, Water OD)
Return type:dict
get_ods_and_params_day(request_ts, request_wvl)[source]

Get total optical thickness and components for a whole day and a certain wavelength

Parameters:
  • request_ts (datetime) – time stamp of requested day
  • request_wvl (float or array) – requested wavelength(s) in [nm]
Returns:

dt_times: time array of requested day
Return type:

datetime
Returns:

od dictionary, containing arrays of optical thicknesses for ‘AOT’, ‘Total’, ‘Rayleigh’, ‘O3’, ‘NO2’, ‘CO2’, ‘CH4’, ‘Water’.
Return type:

dict
Returns:

pressure: pressure array for requested day in [hPa]
Return type:

float
Returns:

total_O3: total ozone column array for requested day in [DU]
Return type:

float
Returns:

total_NO2: total NO2 column array for requested day in [DU]
Return type:

float
get_pressure_o3_no2()[source]

Get pressure in [hPa], total ozone and NO2 column in [DU]

Returns:pressure: pressure array
Return type:float
Returns:total_O3: total ozone column array
Return type:float
Returns:total_NO2: total NO2 column array
Return type:float

cimel_optprop_provider

class aeronet_tools.cimel_optprop_provider.OptpropProvider(datapath)[source]

Provides derived optical properties from AERONET database <= version 2

https://aeronet.gsfc.nasa.gov/cgi-bin/webtool_opera_v2_inv

Parameters:datapath (str) – path to AERONET data
get_phase_function(ts, wvl, p11_type='')[source]

Get phase functions for a specific day and wavelength

Parameters:
  • ts (datetime) – requested day
  • wvl (float) – requested wavelength in [nm]
  • p11_type (str) – phase function type, can be either “”, “fine”, or “coarse”. Default “”.
Returns:

dt_times: time array of requested day
Return type:

datetime
Returns:

sca: scattering angle array of requested day
Return type:

float
Returns:

phase_function: phase function array of requested day
get_refractive_index(ts, wvl)[source]

Get real and imaginary refractive index for a specific day and wavelength(s)

Parameters:
  • ts (datetime) – request datetime time stamp
  • wvl (float or array) – request wavelength(s) in [nm]
Returns:

dt_times: time array of requested day
Return type:

datetime
Returns:

refre: real refractive index array of requested day and wavelength(s)
Return type:

float
Returns:

refim: imaginary refractive index array of requested day and wavelength(s)
Return type:

float
get_ssa(ts, wvl)[source]

Get single scattering albedo (ssa) for a specific day and wavelength(s)

Parameters:
  • ts (datetime) – requested day
  • wvl (float or array) – request wavelength(s) in [nm]
Returns:

dt_times: time array of requested day
Return type:

datetime
Returns:

ssa: single scattering albedo array of requested day and wavelength(s)
Return type:

float

cimel_scan_provider

class aeronet_tools.cimel_scan_provider.ScanProvider(datapath, scan_type='pplane')[source]

Provides scan data from AERONET database <= version 2

https://aeronet.gsfc.nasa.gov/cgi-bin/webtool_opera_v2_inv

Parameters:
  • datapath (str) – path to AERONET data
  • scan_type (str) – scan type, can be either in principal plane (“pplane”) or almucantar (“almu”), default “pplane”
get_scan_radiance_day(date, wvl, nc_pathname=None)[source]

Get radiance values of principal plane or almucantar scans for a certain day and wavelength

Parameters:
  • date (datetime) – requested day
  • wvl (float) – wavelength in [nm]
  • nc_pathname (str) – provide file name if data should be written to netCDF file, default: None
Returns:

times_dt: time array of requested day
Return type:

datetime
Returns:

sca: scattering angles array
Return type:

float
Returns:

rad: array of radiance values for requested day
Return type:

float
aeronet_tools.cimel_scan_provider.save_scans2netCDF(request_time, wavelen, posix_times, sca, rad, fname, nc_pathname)[source]

Saves retrieved data into netCDF file

Parameters:
  • request_time (datetime) – requested day
  • wavelen (float) – requested wavelength(s) in [nm]
  • posix_times (int) – retrieved measurement times of requested day in POSIX time format
  • sca (float) – scattering angles in [deg]
  • rad (float) – radiance values in [mW/(m2 nm sr)]
  • fname (str) – netCDF file name
  • nc_pathname (str) – netCDF path name