Read Lidar

Main functions

class SignalCreation.Read.ReadLidar.ReadLidar(path_file, type_file, force_photocounting_units=None, remove_channel=None, **kwargs)

Parameters:

• path_file (str | List[str])

• type_file (str)

• force_photocounting_units (str | None)

• remove_channel (list | None)

_fill_data_set()

Fill the data array storing the atmospheric profile

_fill_signal_creation()

Fill dataset with a simulated signal

_fill_with_licel()

Reading method to deal with licel lidar files

_fill_with_optimize_filter()

Method to extract lidar signal information from OptimizeFilter output file

_fill_with_teslas()

Reading method to deal with teslas lidar files

_header_licel_teslas()

Method to extract header of teslas and licel files

static _laser_attributes(laser_specific_line)

Method to extract specific attributes of a track :param str laser_specific_line: header line to analyse

Return attributes:

dictionary containing laser track attributes

Return type:

dict

Parameters:

laser_specific_line (str)

_sum_lidar_data_on_time()

If dimension Time is > 1, sum data over this dimension

add_file_to_dataset(path_file)

Add data from file to dataset self._data Used to :

• add a new file to an existing ReadLidar object

• add all the file of the list given as parameter of ReadLidar instance (function in loop in __init__)

Parameters:

path_file (str)

check_and_store_signal_creation_parameters(input_arguments)

(UNUSED in main program) Function that checks and store parameters in case of signal creation (= not reading lidarfile)

Parameters:

input_arguments – Parameters to be given for signal creation. See MANDATORY_PARAMETERS and OPTIONAL_PARAMETERS in Utils/Constants.py

Returns:

static convert_MHz_to_nb_photon(track_MHz, nb_shot, resolution)

Return a copy of the track converted from MHz to photon counting

Parameters:

• track_MHz – Signal channel in MHz

• nb_shot – Number of shot (given in lidar file)

• resolution – Signal resolution (given in lidar file)

Returns:

Copy of signal converted to photon counting

static convert_nb_photon_to_MHz(track_nb_photon, nb_shot, resolution)

Return a copy of the track converted from photon counting to MHz :param track_nb_photon: Photon counting signal channel (no unity) :param nb_shot: Number of shot (given in lidar file) :param resolution: Signal resolution (given in lidar file) :return: Copy of Signal converted to MHz

get_signal(track, altitude=None, unit_altitude=None)

Get the lidar signal at the given altitudes.

If an altitude is outside of the model’s altitude range, the method returns None

Parameters:

• track – str The name of the track

• altitude – float The altitude at which the temperature must be returned

• unit_altitude – str The unit of the altitude

Returns:

xr.DataSet

plot_data(time=0)

Plot all DataArray on subplot figure : x = altitude ; y = file data

remove_channel(remove_channel=None)

Method used to remove some channel from lidar data. Method automatically called in __init__ if remove_channel is defined. Method can also be applied on existing ReadLidar object :param remove_channel: List of file channel indexes not to read :return: None

Parameters:

remove_channel (list | None)