returns the gravitational field data for the current location.


returns the gravitational field data for a location.


returns the component of the gravitational field.

Details and Options

  • GeogravityModelData[] makes use of $GeoLocation to determine your location.
  • locationspec can be specified as latitude and longitude coordinates {lat,lon}, coordinates with a height {lat,lon,h}, GeoPosition[], or as a named Entity[]. h can be input as a numeric object in meters or as a Quantity.
  • locationspec can also be a region as specified by a named Entity[] or a listed pair of specific locations {locationspec1,locationspec2} or {locationspec1,locationspec2,h}.
  • Location can also be specified as Association["Location"->locationspec].
  • For regions, results are returned as arrays or an Association of arrays of gravitational fields by default. Arrays are calculated at the geographic height of a specific coordinate point of the grid above the reference datum unless otherwise specified. If that data is not available, it uses a default height of 0 meters.
  • Components include "NorthComponent", "EastComponent", "DownComponent", "HorizontalComponent", "Declination", "Inclination", and "Magnitude". Components are measured relative to the reference ellipsoid "WGS84Original".
  • "DownComponent" is measured relative to the perpendicular to the reference ellipsoid where positive values are downward. "HorizontalComponent" is the field parallel to the surface at that point. "Declination" is the angle between the north and east components. "Inclination" is the angle between the horizontal component and the vertical component. "Magnitude" is the total magnitude of the field. "Potential" is the gravitational potential.
  • Components and "Magnitude" are returned in meters per second squared. "Inclination" and "Declination" are returned in angular degrees. "Potential" is returned in joules per kilogram.
  • All gravitational field components are returned as an Association unless a specific component is requested.
  • GeogravityModelData[locationspec,component,func] is used to specify the format of output when extended locations are specified.
  • Possible settings for func include:
  • Allreturn all values for extended locations
    GeoVectorreturn components as a GeoVector object
    GeoVectorENUreturn components as a GeoVectorENU object
    Intervalreturn intervals for extended locations
    Maxreturn maximum values for extended locations
    Meanreturn mean value for extended locations
    Minreturn minumum values for extended locations
    StandardDeviationreturn standard deviation for extended locations
  • GeoVector and GeoVectorENU are not available for "Potential" or "Magnitude" components.
  • GeogravityModelData takes the following options:
  • MethodAutomaticspecific components to include in the calculation
    GeoZoomLevelAutomaticlevel of detail for gravitational field arrays
  • Method takes a suboption "ModelDegree" that controls the order of the gravitational model used. It can be set to integer values between 2 and 360 inclusive.
  • Method also takes a suboption "IncludeRotation" that can be set to True to include the effects of the Earth's rotation in the calculation of the acceleration field components.
  • The spatial resolution of the requested gravitational field data can be selected with the option GeoZoomLevelzoom, where zoom is an integer.
  • Data is based on EGM96 (Earth Gravitational Model 1996) on the WGS 84 ellipsoid.


open all close all

Basic Examples  (1)

Find the gravitational field components at a geographic position:

Click for copyable input

Use Entity to specify a location:

Click for copyable input

Scope  (10)

Options  (4)

Applications  (3)

Possible Issues  (1)

Neat Examples  (3)

Introduced in 2015
Updated in 2019