uk.me.g4dpz.satellite.SatelliteFactory Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of predict4java Show documentation

predict4java provides real-time satellite tracking and orbital prediction information

The newest version!

/**
    predict4java: An SDP4 / SGP4 library for satellite orbit predictions

    Copyright (C)  2004-2010  David A. B. Johnson, G4DPZ.

    This class is a Java port of one of the core elements of
    the Predict program, Copyright John A. Magliacane,
    KD2BD 1991-2003: http://www.qsl.net/kd2bd/predict.html

    Dr. T.S. Kelso is the author of the SGP4/SDP4 orbital models,
    originally written in Fortran and Pascal, and released into the
    public domain through his website (http://www.celestrak.com/).
    Neoklis Kyriazis, 5B4AZ, later re-wrote Dr. Kelso's code in C,
    and released it under the GNU GPL in 2002.
    PREDICT's core is based on 5B4AZ's code translation efforts.

    Author: David A. B. Johnson, G4DPZ 

    Comments, questions and bugreports should be submitted via
    http://sourceforge.net/projects/websat/
    More details can be found at the project home page:

    http://websat.sourceforge.net

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, visit http://www.fsf.org/
 */
package uk.me.g4dpz.satellite;

/**
 * The factory which creates a LEO or Deep Space Satellite.
 *
 * @author G4DPZ
 *
 */
public final class SatelliteFactory {

    /**
     * Default constructor.
     */
    private SatelliteFactory() {

    }

    /**
     * Creates a Satellite from a TLE.
     *
     * @param tle The 'Three Line Elements'
     * @return Satellite
     * @throws IllegalArgumentException when the given TLE is null or the data is incorrect
     */
    public static synchronized Satellite createSatellite(final TLE tle)
            throws IllegalArgumentException {

        if (null == tle) {
            throw new IllegalArgumentException("TLE was null");
        }

        Satellite satellite = null;

        if (tle.isDeepspace()) {
            satellite = new DeepSpaceSatellite(tle);
        }
        else {
            satellite = new LEOSatellite(tle);
        }
        return satellite;
    }
}