org.orekit.forces.gravity
Class EarthGravitationalModelFactory

java.lang.Object
  org.orekit.forces.gravity.EarthGravitationalModelFactory

public final class EarthGravitationalModelFactory
extends Object

Factory class for earth gravitational model. This factory provides earth gravitational model by giving the potential file name, the degree and the order.

Since:

2.3

Version:

$Id: EarthGravitationalModelFactory.java 10756 2014-09-15 08:39:38Z maggiorani $

Author:

Charlotte Maggiorani

See Also:

BalminoAttractionModel, CunninghamAttractionModel, DrozinerAttractionModel, GravityFieldFactory

Use sample :

final ForceModel model = EarthGravitationalModelFactory.getGravitationalModel(potentialFileName, n, m);

Concurrency :

not thread-safe

Concurrency comment :

the presence of static methods makes this class not thread-safe

Nested Class Summary

static class

EarthGravitationalModelFactory.GravityFieldNames Gravity field names enumerate.

Method Summary

static ForceModel	getBalmino(EarthGravitationalModelFactory.GravityFieldNames potentialFileName, int n, int m) Create an instance of a central body attraction with normalized coefficients and Helmholtz Polynomials (Balmino model).
static ForceModel	getCunningham(EarthGravitationalModelFactory.GravityFieldNames potentialFileName, int n, int m) Create an instance of the gravitational field of a celestial body using Cunningham model.
static ForceModel	getDroziner(EarthGravitationalModelFactory.GravityFieldNames potentialFileName, int n, int m) Create an instance of the gravitational field of a celestial body using Droziner model.
static ForceModel	getGravitationalModel(EarthGravitationalModelFactory.GravityFieldNames potentialFileName, int n, int m) Create an default instance of a gravitational field of a celestial body using Balmino model.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getGravitationalModel

public static ForceModel getGravitationalModel(EarthGravitationalModelFactory.GravityFieldNames potentialFileName,
                                               int n,
                                               int m)
                                        throws IOException,
                                               ParseException,
                                               OrekitException

Create an default instance of a gravitational field of a celestial body using Balmino model.

Parameters:

potentialFileName - the gravity field name

n - the degree

m - the order

Returns:

an instance of the gravitational field of a celestial body

Throws:

IOException - if data can't be read

ParseException - if data can't be parsed

OrekitException - if some data is missing or if some loader specific error occurs

Since:

2.3

See Also:

BalminoAttractionModel

getBalmino

public static ForceModel getBalmino(EarthGravitationalModelFactory.GravityFieldNames potentialFileName,
                                    int n,
                                    int m)
                             throws IOException,
                                    ParseException,
                                    OrekitException

Create an instance of a central body attraction with normalized coefficients and Helmholtz Polynomials (Balmino model).

Parameters:

potentialFileName - the gravity field name

n - the degree

m - the order

Returns:

an instance of the gravitational field of a celestial body

Throws:

IOException - if data can't be read

ParseException - if data can't be parsed

OrekitException - if some data is missing or if some loader specific error occurs

Since:

2.3

See Also:

BalminoAttractionModel

getCunningham

public static ForceModel getCunningham(EarthGravitationalModelFactory.GravityFieldNames potentialFileName,
                                       int n,
                                       int m)
                                throws IOException,
                                       ParseException,
                                       OrekitException

Create an instance of the gravitational field of a celestial body using Cunningham model.

Parameters:

potentialFileName - the gravity field name

n - the degree

m - the order

Returns:

an instance of the gravitational field of a celestial body

Throws:

IOException - if data can't be read

ParseException - if data can't be parsed

OrekitException - if some data is missing or if some loader specific error occurs

Since:

2.3

See Also:

CunninghamAttractionModel

getDroziner

public static ForceModel getDroziner(EarthGravitationalModelFactory.GravityFieldNames potentialFileName,
                                     int n,
                                     int m)
                              throws IOException,
                                     ParseException,
                                     OrekitException

Create an instance of the gravitational field of a celestial body using Droziner model.

Parameters:

potentialFileName - the gravity field name

n - the degree

m - the order

Returns:

an instance of the gravitational field of a celestial body

Throws:

IOException - if data can't be read

ParseException - if data can't be parsed

OrekitException - if some data is missing or if some loader specific error occurs

Since:

2.3

See Also:

DrozinerAttractionModel