harmonica.synthetic.ground_survey

harmonica.synthetic.ground_survey(region=None, data_region=(13.6, 20.3, - 24.2, - 17.5))[source]

Create measurement locations for a synthetic ground survey

The observation points are sampled from the South Africa gravity dataset (see fetch_south_africa_gravity). Only a portion of the original survey is sampled and its region may be scaled to the passed region.

Parameters
  • region (tuple or list (optional)) – Region at which the survey points coordinates will be scaled. The boundaries must be passed in the following order: (east, west, south, north, …), defined on a geodetic coordinate system and in degrees. All subsequent boundaries will be ignored. If None, the survey points won’t be scaled. Default None.

  • data_region (tuple or list (optional)) – Region where the original Great Britain magnetic dataset will be sampled. The boundaries must be passed in the following order: (east, west, south, north, …), defined on a geodetic coordinate system and in degrees. All subsequent boundaries will be ignored.

Returns

survey (pandas.DataFrame) – Dataframe containing the coordinates of the observation points on a geodetic coordinate system. The pandas.DataFrame will have the following columns: longitude, latitude, height. Longitudes and latitudes are in degrees, and heights in meters.