boule
Calculate reference-ellipsoid geometry, normal gravity and geodetic/geocentric coordinate conversions with Boule. Use for gravity reference corrections and planetary ellipsoids; this does not transform between geodetic datums or compute terrain corrections.
Geoscience Skills · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add SteadfastAsArt/geoscience-skills --skill boule技能说明
name: boule description: Calculate reference-ellipsoid geometry, normal gravity and geodetic/geocentric coordinate conversions with Boule. Use for gravity reference corrections and planetary ellipsoids; this does not transform between geodetic datums or compute terrain corrections. license: MIT metadata: version: "1.0.0" author: Geoscience Skills skill_type: domain tags: '["Geodesy", "Gravity", "Reference Ellipsoid"]' dependencies: '["boule==0.6.0"]' complements: '["harmonica", "ensaio", "verde"]' workflow_role: processing
Boule
Use the ellipsoid and coordinate convention attached to the actual observations. An ellipsoid is a reference surface; choosing WGS84 does not transform coordinates from another datum or reference epoch.
Inputs and conventions
For the 0.6 API, coordinates are a tuple (longitude, latitude, height) for
geodetic input: angles in degrees, ellipsoidal height in metres. Spherical input
uses geocentric latitude and radius in metres, not elevation. Orthometric height
above a geoid requires a separate geoid model before use as ellipsoidal height.
Choose an existing ellipsoid such as WGS84 or GRS80 from source metadata, or
define a documented body with consistent parameters. Do not infer the ellipsoid
from a column merely called height.
Gravity and coordinate conversion
# example: ellipsoid-gravity
import numpy as np
import boule
longitude_deg = np.array([0.0, 10.0, 0.0])
latitude_deg = np.array([0.0, 45.0, 90.0])
height_m = np.zeros(3)
geodetic = (longitude_deg, latitude_deg, height_m)
gravity_mgal = boule.WGS84.normal_gravity(geodetic)
gravity_si = boule.WGS84.normal_gravity(geodetic, si_units=True)
spherical = boule.WGS84.geodetic_to_spherical(geodetic)
roundtrip = boule.WGS84.spherical_to_geodetic(spherical)
Default gravity is mGal: 1 mGal = 10⁻⁵ m/s². At zero height, reference gravity is about 9.7803253 m/s² at the equator and 9.8321849 m/s² at the poles. Mid-latitude geocentric latitude differs from geodetic latitude. Check both units and limits.
Applying corrections
Specify whether the requested quantity is observed gravity, normal gravity, disturbance or anomaly, with its height and sign convention. Subtraction of normal gravity alone is not a Bouguer, terrain or tide correction. Preserve instrument units and datum/epoch provenance through any handoff to a potential-field model.
Read the normal gravity guide and API for the selected body.