Skip to content

gravitools.aqg.tilt

Functions for processing an AQG tilt offset calibration measurement

TiltOffset(x, y, g=0, u_x=0, u_y=0, u_g=0) dataclass

AQG tilt offset fit result

plot(**kwargs)

Plot as a 2D tilt graph with a circle for 1 µGal

AQGTiltAnalysis(datapoints, result, name=None, datasets=None) dataclass

Summary of an AQG tilt offset analysis

fit(datapoints, datasets=None, name=None) classmethod

Fit the tilt offset from a list of data points

plot_tilt_offset(label=None, **kwargs)

Plot tilt offset result

plot_tilt_distribution(ax=None)

Plot 2D distribution of tilt angles

plot_residuals(ax=None)

Plot residuals against effective angle

plot_datasets(indices=None, ylim=None)

Plot individual measurements

draw_circle(x, y, radius, ax=None, n=100, **kwargs)

Draw a circle in a Matplotlib graph

plot_tilt_offset(x, y, origin=(0, 0), *, circle=True, ax=None, **kwargs)

Draw tilt offset position on a Matplotlib graph

Parameters:

  • x (float) –

    Tilt offset in X axis.

  • y (float) –

    Tilt offset in Y axis.

  • origin (tuple(float, float), default: (0, 0) ) –

    Plot origin coordinate.

  • circle (bool, default: True ) –

    Draw a circle around the position indicating a 10 nm/s² uncertainty.

  • ax –

    Axis on which to draw the plot.

  • **kwargs (dict, default: {} ) –

    Arguments to pass on to matplotlib.pyplot.scatter().

fit_model(tilt_xy, offset_x, offset_y, g_true)

Model used to fit tilt calibration measurements

See also tilt_correction().

Parameters:

  • tilt_xy (ndarray) –

    2D array of X and Y tilt angles, in radian.

  • offset_x (ndarray) –

    Tilt offset in X direction, in radian.

  • offset_y (ndarray) –

    Tilt offset in X direction, in radian.

  • g_true (ndarray) –

    Gravity value at verticality, in nm/s².

Returns:

  • ndarray –

    Absolute gravity value reduced due to instrument tilt.

perform_tilt_offset_fit(tilt_x, tilt_y, g, g_err)

Fit tilt offset values from set of calibration datapoints

Parameters:

  • tilt_x (ndarray) –

    Instrument tilt in X direction, in radian.

  • tilt_y (ndarray) –

    Instrument tilt in Y direction, in radian.

  • g (ndarray) –

    Measured absolute gravity, in nm/s².

  • g_err (ndarray) –

    Standard uncertainty of measured gravity, in nm/s².

Returns:

calculate_tilt_dataset_means(datasets)

Calculate mean values of an AQG tilt offset calibration dataset

analyze_aqg_tilt_calibration(rawdata_paths, config=None, name=None)

Perform an AQG tilt offset calibration from a list of rawdata files

Parameters:

  • rawdata_paths (list[str | Path | Path]) –

    List of file paths to AQG raw datasets

  • config (dict, default: None ) –

    Processing configuration parameters.

  • name (str, default: None ) –

    Identifier name for this calibration measurement. If unspecified, the date of the first dataset is chosen.

Returns:

plot_tilt_analyses(tilt_analyses, origin=None, **kwargs)

Plot multiple tilt analyis results