invert4geom.DatasetAccessorInvert4Geom.regional_constant

DatasetAccessorInvert4Geom.regional_constant(constant=None, constraints_df=None, regional_shift=0, mask_column=None, reverse_regional_residual=False)

Calculate the gravity misfit as the difference between dataset variables gravity_anomaly and forward_gravity. Then separate the misfit into regional and residual components where residual = misfit - regional.

Approximate the regional field with a constant value supplied with constant. If constraints_df is supplied, the constant value will instead be the median misfit value at the constraint points.

The resulting regional field can be shifted with regional_shift, and the calculated residual field can be multiplied by the values in mask_column.

The following new variables are added to the dataset:

misfit, reg, res, starting_forward_gravity, starting_misfit, starting_reg, starting_res

Parameters:

• constant (float) – value to use for the regional field.

• constraints_df (pandas.DataFrame) – a dataframe of constraint points with columns easting and northing (or longitude and latitude).

• regional_shift (float, optional) – shift to add to the regional field, by default 0

• mask_column (str | None, optional) – Name of optional dataset variable with values to multiply the calculated residual gravity field by, should have values of 1 or 0, by default None.

• reverse_regional_residual (bool, optional) – if True, reverse the regional and residual fields after calculation, by default False

Return type:

None

See also

DatasetAccessorInvert4Geom.regional_separation