GeogravityModelDataCopy to clipboard.
✖
GeogravityModelData
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:
-
All return all values for extended locations GeoVector return components as a GeoVector object GeoVectorENU return components as a GeoVectorENU object Interval return intervals for extended locations Max return maximum values for extended locations Mean return mean value for extended locations Min return minumum values for extended locations StandardDeviation return standard deviation for extended locations - GeoVector and GeoVectorENU are not available for "Potential" or "Magnitude" components.
- GeogravityModelData takes the following options:
-
Method Automatic specific components to include in the calculation GeoZoomLevel Automatic level 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 a positive or negative integer. The larger the integer is, the more points are used to construct the array of data.
- Data is based on EGM96 (Earth Gravitational Model 1996) on the WGS 84 ellipsoid.
Examples
open allclose allBasic Examples (1)Summary of the most common use cases
Find the gravitational field components at a geographic position:
https://wolfram.com/xid/0comswep55z4q3s5287m-pp365g
Use Entity to specify a location:
https://wolfram.com/xid/0comswep55z4q3s5287m-3y9x34
Scope (10)Survey of the scope of standard use cases
Location Specification (5)
Find the gravitational field components for the current location:
https://wolfram.com/xid/0comswep55z4q3s5287m-szl1pu
Location can be given as a list of coordinates and local height:
https://wolfram.com/xid/0comswep55z4q3s5287m-f02paq
Coordinates and height can be specified with Quantity:
https://wolfram.com/xid/0comswep55z4q3s5287m-sgodzi
Find an array of gravitational fields over a rectangular region defined by two points:
https://wolfram.com/xid/0comswep55z4q3s5287m-pdj1fl
Points can be specified with GeoPosition or Entity:
https://wolfram.com/xid/0comswep55z4q3s5287m-0ifbkn
Set the height at which the gravitational field will be calculated over the region:
https://wolfram.com/xid/0comswep55z4q3s5287m-9pea9r
Calculate the gravitational field over the region defined by an Entity:
https://wolfram.com/xid/0comswep55z4q3s5287m-nwmtjk
https://wolfram.com/xid/0comswep55z4q3s5287m-1ov99d
Component Specification (3)
Request specific components of the gravitational field:
https://wolfram.com/xid/0comswep55z4q3s5287m-u5eibl
https://wolfram.com/xid/0comswep55z4q3s5287m-1cnmhn
Find the derived components of a gravitational field:
https://wolfram.com/xid/0comswep55z4q3s5287m-7wjuvu
Calculate the magnitude of the gravitational field:
https://wolfram.com/xid/0comswep55z4q3s5287m-ftng51
Format Specification (2)
Find the range of the east component for an extended region:
https://wolfram.com/xid/0comswep55z4q3s5287m-evvli9
Obtain the maximum or mean value of a component for a region:
https://wolfram.com/xid/0comswep55z4q3s5287m-cnzm38
https://wolfram.com/xid/0comswep55z4q3s5287m-53nrn3
Options (4)Common values & functionality for each option
GeoZoomLevel (1)
Control the size of the array produced for an extended region using GeoZoomLevel:
https://wolfram.com/xid/0comswep55z4q3s5287m-r3h41l
https://wolfram.com/xid/0comswep55z4q3s5287m-paankw
Method (3)
Increase the accuracy of the results by increasing the "ModelDegree" setting for the Method option:
https://wolfram.com/xid/0comswep55z4q3s5287m-upg6ah
Examine how the down component changes with increasing degrees of the model:
https://wolfram.com/xid/0comswep55z4q3s5287m-rp9zm1
https://wolfram.com/xid/0comswep55z4q3s5287m-9dec8y
Use "IncludeRotation" to examine the effect of the Earth's rotation on net gravitational acceleration:
https://wolfram.com/xid/0comswep55z4q3s5287m-jbcwk1
https://wolfram.com/xid/0comswep55z4q3s5287m-ct5ci5
Applications (3)Sample problems that can be solved with this function
Find the magnitude of the gravitational field at a location:
https://wolfram.com/xid/0comswep55z4q3s5287m-i0tyo8
Calculate the angle to the vertical:
https://wolfram.com/xid/0comswep55z4q3s5287m-le089a
https://wolfram.com/xid/0comswep55z4q3s5287m-lz95n7
Calculate the inclination of the gravitational field for major cities in France:
https://wolfram.com/xid/0comswep55z4q3s5287m-gu3wn1
https://wolfram.com/xid/0comswep55z4q3s5287m-2qakgx
Examine the distribution of values as a divergence from the vertical:
https://wolfram.com/xid/0comswep55z4q3s5287m-fe0d03
Examine how the gravity model deviates from the theoretical gravitational acceleration:
https://wolfram.com/xid/0comswep55z4q3s5287m-8udlk6
https://wolfram.com/xid/0comswep55z4q3s5287m-e4kgh6
Possible Issues (1)Common pitfalls and unexpected behavior
Coordinates must be in the correct dimensions:
https://wolfram.com/xid/0comswep55z4q3s5287m-sq79e3
"ModelDegree" should be an integer between 2 and 360:
https://wolfram.com/xid/0comswep55z4q3s5287m-dso66u
https://wolfram.com/xid/0comswep55z4q3s5287m-njngeu
Neat Examples (3)Surprising or curious use cases
Examine how the period differs in different locations for a 1-meter-long pendulum with a displacement of 1 degree:
https://wolfram.com/xid/0comswep55z4q3s5287m-0q4l4
https://wolfram.com/xid/0comswep55z4q3s5287m-8p8ypr
Examine how the Earth's gravitational field differs from the standard value of 9.81 over a region:
https://wolfram.com/xid/0comswep55z4q3s5287m-sdqn0x
https://wolfram.com/xid/0comswep55z4q3s5287m-uhh69q
Examine the magnitude of the gravitational field across the entire planet:
https://wolfram.com/xid/0comswep55z4q3s5287m-b9656h
https://wolfram.com/xid/0comswep55z4q3s5287m-2tezw9
Wolfram Research (2015), GeogravityModelData, Wolfram Language function, https://reference.wolfram.com/language/ref/GeogravityModelData.html (updated 2019).
Text
Wolfram Research (2015), GeogravityModelData, Wolfram Language function, https://reference.wolfram.com/language/ref/GeogravityModelData.html (updated 2019).
Wolfram Research (2015), GeogravityModelData, Wolfram Language function, https://reference.wolfram.com/language/ref/GeogravityModelData.html (updated 2019).
CMS
Wolfram Language. 2015. "GeogravityModelData." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2019. https://reference.wolfram.com/language/ref/GeogravityModelData.html.
Wolfram Language. 2015. "GeogravityModelData." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2019. https://reference.wolfram.com/language/ref/GeogravityModelData.html.
APA
Wolfram Language. (2015). GeogravityModelData. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/GeogravityModelData.html
Wolfram Language. (2015). GeogravityModelData. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/GeogravityModelData.html
BibTeX
@misc{reference.wolfram_2024_geogravitymodeldata, author="Wolfram Research", title="{GeogravityModelData}", year="2019", howpublished="\url{https://reference.wolfram.com/language/ref/GeogravityModelData.html}", note=[Accessed: 10-January-2025
]}
BibLaTeX
@online{reference.wolfram_2024_geogravitymodeldata, organization={Wolfram Research}, title={GeogravityModelData}, year={2019}, url={https://reference.wolfram.com/language/ref/GeogravityModelData.html}, note=[Accessed: 10-January-2025
]}