Data Schemas#

GMN data fields are accessible through Pandas DataFrames produced by the gmn-python-api library. See the meteor_trajectory_schema API Reference section for function and variable details.

Accessing meteor trajectory fields code example#

from gmn_python_api import data_directory as dd
from gmn_python_api import meteor_trajectory_reader

# Access column names (verbose)
traj_file_content = dd.get_daily_file_content_by_date("2019-07-24")
traj_df = meteor_trajectory_reader.read_data(
    traj_file_content,
    output_camel_case=False,
)

traj_df.iloc[0]['Vgeo (km/s)']
# 63.95235

# Access column names (camel case)
traj_file_content = dd.get_daily_file_content_by_date("2019-07-24")
traj_df = meteor_trajectory_reader.read_data(
    traj_file_content,
    output_camel_case=True,
)

traj_df.iloc[0]['vgeo_km_s']
# 63.952355

The model data file is meteor_trajectory_schema._MODEL_METEOR_TRAJECTORY_FILE_PATH. The one line version of the file is meteor_summary_schema._MODEL_METEOR_TRAJECTORY_FILE_ONE_ROW_PATH.

Verbose and camel case column names can be found below.

Meteor Trajectory Features#

Listing of current data schema (version 1.0).

Verbose Name

Camel Case Name

Description

Unique trajectory (identifier)

unique_trajectory_identifier

(Index) A 20-character string containing the beginning time (rounded to seconds) and a truncated MD5 hash encoding the trajectory position.

Beginning Julian date

beginning_julian_date

Julian date of the beginning of the meteor.

Beginning (UTC Time)

beginning_utc_time

UTC time of the beginning of the meteor.

IAU (No)

iau_no

IAU shower number, see https://www.ta3.sk/IAUC22DB/MDC2007/Roje/roje_lista.php. Sporadic meteors have a code -1.

IAU (code)

iau_code

Three-letter IAU shower code. Sporadic meteors have a code “…”.

Sol lon (deg)

sol_lon_deg

Solar longitude of the beginning of the meteor.

App LST (deg)

app_lst_deg

Apparent local sidereal time of the beginning of the meteor.

RAgeo (deg)

rageo_deg

Geocentric right ascension in the J2000 epoch.

+/- (sigma) or +/- (sigma.x)

sigma or sigma_x

One sigma error (repeated for every previous value). sigma (without number) is the first value. The rest contain a number starting at 1.

DECgeo (deg)

decgeo_deg

Geocentric declination in the J2000 epoch.

LAMgeo (deg)

lamgeo_deg

Geocentric ecliptic longitude in the J2000 epoch.

BETgeo (deg)

betgeo_deg

Geocentric ecliptic latitude in the J2000 epoch.

Vgeo (km/s)

vgeo_km_s

Geocentric velocity.

LAMhel (deg)

lamhel_deg

Heliocentric ecliptic longitude in the J2000 epoch.

BEThel (deg)

bethel_deg

Heliocentric ecliptic latitude in the J2000 epoch.

Vhel (deg)

vhel_km_s

Heliocentric velocity.

a (AU)

a_au

Semi-major axis.

e

e

Eccentricity.

i (deg)

i_deg

Inclination.

peri (deg)

peri_deg

Argument of perihelion.

node (deg)

node_deg

Ascending node.

Pi (deg)

pi_deg

Longitude of perihelion.

b (deg)

b_deg

Latitude of perihelion.

q (AU)

q_au

Perihelion distance.

f (deg)

f_deg

True anomaly at the beginning of the meteor.

M (deg)

m_deg

Mean anomaly.

Q (AU)

q_au_

Aphelion distance.

n (deg/day)

n_deg_day

Mean motion in the orbit.

T

t_years

Orbital period.

TisserandJ

tisserandj

Tisserand’s parameter with respect to Jupiter.

RAapp (deg)

raapp_deg

Apparent ground-fixed radiant right ascension in the epoch of date.

DECapp (deg)

decapp_deg

Apparent ground-fixed radiant declination in the epoch of date.

Azim +E (of N deg)

azim_e_of_n_deg

Apparent ground-fixed radiant azimuth (+east of due north convention).

Elev (deg)

elev_deg

Apparent ground-fixed radiant elevation (i.e. entry angle).

Vinit (km/s)

vinit_km_s

Apparent ground-fixed initial velocity.

Vavg (km/s)

vavg_km_s

Apparent ground-fixed average velocity.

LatBeg (+N deg)

latbeg_n_deg

Latitude of the beginning of the meteor.

LonBeg (+E deg)

lonbeg_e_deg

Longitude of the beginning of the meteor.

HtBeg (km)

htbeg_km

Begin height of the meteor (above the WGS84 ellipsoid).

LatEnd (+N deg)

latend_n_deg

Latitude of the meteor end.

LonEnd (+E deg)

lonend_e_deg

Longitude of the meteor end.

HtEnd (km)

htend_km

End height of the meteor (above the WGS84 ellipsoid).

Duration (sec)

duration_sec

Observed meteor duration.

Peak (AbsMag)

peak_absmag

Peak magnitude normalized to the range of 100 km.

Peak Ht (km)

peak_ht_km

Height at which with peak magnitude occured.

F (param)

f_param

The F parameter defined as (HtBeg - PeakHt)/(HtBeg - HtEnd)

Mass kg (tau=0.7%)

mass_kg_tau_0_7

Mass in kilograms computed with a dimensionless luminous efficiency of 0.7%.

Qc (deg)

qc_deg

Maximum convergence angle between all stations that observed the meteor.

MedianFitErr (arcsec)

medianfiterr_arcsec

Median angular trajectory fit errors in arc seconds.

Beg in (FOV)

beg_in_fov

Beginning of the meteor observed by at least one camera.

End in (FOV)

end_in_fov

Ending of the meteor observed by at least one camera.

Num (stat)

num_stat

Number of stations which observed the meteor.

Participating (stations)

participating_stations

Station codes of stations which observed the meteor.

Source: https://globalmeteornetwork.org/data/media/GMN_orbit_data_columns.pdf