1.3. cpforager.AXY

class cpforager.AXY(df, group, id, params)

A class to represent the AXY data of a central-place foraging seabird.

__init__(df, group, id, params)

Constructor of an AXY object.

Parameters:

  • df (pandas.DataFrame) – the dataframe containing datetime, ax, ay, az, longitude, latitude, pressure and temperature columns. Type of datetime column must be datetime64.

  • group (str) – the string representing the group to which the AXY data belongs (e.g. species, year, fieldwork, etc.) useful for statistics and filtering.

  • id (str) – the string representing the unique identifier of the central-place foraging seabird.

  • params (dict) – the parameters dictionary.

Variables:

  • df (pandas.DataFrame) – the dataframe containing the raw and processed AXY data.

  • group (str) – The string representing the group to which the AXY data belongs (e.g. species, year, fieldwork, etc.) useful for statistics and filtering.

  • id (str) – The string representing the unique identifier of the central-place foraging seabird.

  • params (dict) – The dictionary containing the parameters used for the AXY data processing.

  • n_df (int) – the number of measures in the AXY recording.

  • gps (cpforager.GPS) – the GPS data of AXY at GPS resolution.

  • df_gps (pandas.DataFrame) – the dataframe containing AXY data at GPS resolution.

  • tdr (cpforager.TDR) – the TDR data of AXY at TDR resolution.

  • df_tdr (pandas.DataFrame) – the dataframe containing AXY data at TDR resolution.

  • start_datetime (datetime.datetime) – the starting datetime of the AXY recording.

  • end_datetime (datetime.datetime) – the ending datetime of the AXY recording.

  • frequency (float) – the frequency of the AXY data in Hz.

  • total_duration (float) – the total duration of the AXY recording in days.

  • max_odba (float) – the maximum overall dynamical body acceleration.

  • median_odba (float) – the median overall dynamical body acceleration.

  • max_odba_f (float) – the maximum filtered overall dynamical body acceleration.

  • median_odba_f (float) – the median filtered overall dynamical body acceleration.

Methods

__init__(df, group, id, params)

Constructor of an AXY object.

display_data_summary([standalone])

Print in terminal the AXY data summary.

folium_map(fig_dir, file_id, plot_params)

Produce the html map of the GPS data with the possibility to choose a color gradient.

full_diag(fig_dir, file_id, plot_params[, fast])

Produce the full diagnostic of the AXY data.

interpolate_lat_lon(interp_datetime[, add_proxy])

Interpolate longitude and latitude at a given datetime.

maps_diag(fig_dir, file_id, plot_params)

Produce the maps of the GPS data.