Skip to content

Latest commit

 

History

History
35 lines (23 loc) · 3.05 KB

README.md

File metadata and controls

35 lines (23 loc) · 3.05 KB

GaMA

The Gravitational and Mesh Adaptation library is a set of optimized matlab classes used to model the gravitational fields of asteroids and comets. Implemented gravity models include: the spherical harmonic model [1], analytic polyhedral model [2], mascon model [3], approximate polyhedral model [4], and a curvilinear surface model [5]. It contains a number of supporting classes and functions required to initialize the gravitational models, integrate trajectories, and post-process results. The gravitational models are easy to initialize and contain methods to calculate the potential, acceleration, laplacian, and gravitational gradient given a position. It also gives the user the ability to create composite models -- superimposing as many base models as desired. The current version is serial.

Getting Started

To access the classes and functions of GaMA, add the directory tree to the run path. This can be done by running the following command:

addpath(genpath('/path/to/GaMA')) 

A number of example scripts highlight different functionality within the code and can be found in the scripts/Examples subdirectory. Included is a script that integrates a trajectory around Asteroid Eros and is a good starting point. Another script shows how to calculate the gravity slopes on the surface of Eros and export the results to a vtk file for viewing with Paraview or Visit.

Eros Slopes

Version Requirements

GaMA can be run with Matlab or GNU Octave* and does not require pay-for toolboxes. The current version of GaMA has been tested on Matlab versions R2018b-R2021b and GNU Octave 7.1.0. Portions of the code make use of implicit expansion and this will cause errors when used with Matlab R2016b or earlier. The vecnorm function is also used which was not introduced until R2017b. Note with GNU Octave performance is notably worse and

warning('off','Octave:data-file-in-path')

can be used to suppress the fopen warning associated with searching the load path for file names. GNU Octave 5.2.0 is incompatible.

Contributing

Contribution are welcome and those interested in contributing should see the CONTRIBUTING file for details.

Release and License

Copyright (c) 2022, Lawrence Livermore National Security, LLC.

This work was produced under the auspices of the U.S. Department of Energy by Lawrence Livermore National Laboratory under Contract DE-AC52-07NA27344, with additional funding by the Vermont Space Grant Consortium under NASA Cooperative Agreement NNX15AP86H.

LLNL-CODE-830936

Written by Jason M. Pearl pearl3@llnl.gov

see the LISCENSE and NOTICE files for details.