astro

Class Resolver

java.lang.Object

astro.Resolver

public final class Resolver
extends Object

A class used to resolve targets by names, get their postions and field of view. Uses different techniques, i.e. databse look-up and SIMBAD queries. Allows matching of different query results to avoid multiple refernces to the same star.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Resolver.CatalogServlet Tries the servlet catalog method.
static class	Resolver.DbServlet Tries the servlet catalog method.
static class	Resolver.NameServlet Tries the servlet resolve method.
static class	Resolver.Print A simple test class.

Field Summary

Fields

Modifier and Type	Field and Description
private static String	BRIGHTESTSTARRESOURCE The resource name for serialized bright star catalog.
private URL	brighteststars The URL for the serialized brightes star catalog.
private static String	BRIGHTSTARRESOURCE The resource name for serialized bright star catalog.
private URL	brightstars The URL for the serialized bright star catalog.
private static String	HIPPSTARRESOURCE The resource name for serialized hipparchos star catalog.
private URL	hippstars The URL for the serialized Hipparchos star catalog.
private static List<String>	NAMEPRIORITY A priority list for star names.
private static Resolver	r Singleton instance.
private boolean	remote The class loader used for resolving local resources cannot be accessed.
private static String	REMOTEDB The db-servlet.
private static String	REMOTESESAME The Sesama servlet URL.
private static String	REMOTEVIZIER The Vizier servlet URL.
private boolean	servlet Do not bother with DB, use servlet.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	Resolver(boolean onlyservlet) To catch malformed URL's, we initialize here the bright star catalog and the brightst star catalog serialized URL's.

Method Summary

Modifier and Type	Method and Description
void	applyClassLoader(ClassLoader c)
List<Star>	databaseFromPpmXl(Star center, Double radius) Queries a field-of-view around a central star using the UCAC2 plus Supplement merged database on furmint.
List<Star>	databaseFromPpmXlFaint(Star center, Double radius) Queries a field-of-view around a central star using the UCAC2 plus Supplement merged database on furmint.
List<Star>	emptyList(Star center, Double radius) Returns an empty list.
static Resolver	getInstance()
static Resolver	getInstance(boolean servlet)
boolean	isRemote()
private Star	resolveServlet(String name, boolean common) In VM, where the class loader cannot be read (unsigned applets), we rely instead on a servlet running on #REMOTEURL to which we pass the name and the common parameter.
private Star	resolveSesame(String name, boolean common) We use the normal Sesame-resolving service based on axis protocols.
Star	resolveSimbad(String name) Queries the SIMBAD service using their AXIS protocol.
Star	resolveSimbad(String name, boolean common) Queries the SIMBAD service using their AXIS protocol.
private List<Star>	serializedFoV(URL catalog, Star center, double radius) Deserializes a SimpleStar list from the given URL and returns all stars within the radius around the center given.
List<Star>	serializedFromBrightestStars(Star center, Double radius) Queries the serialized version of the brightest-star catalog.
List<Star>	serializedFromBSC(Star center, Double radius) Queries the serialized version of the bright star catalog.
List<Star>	serializedFromHipparchos(Star center, Double radius) Queries the serialized version of the bright star catalog.
private List<Star>	servletDataBase(Star center, double radiusdeg)
private List<Star>	servletRetrieve(VizierStarParser vizier, Star center, double radius)
private List<Star>	vizierFoV(Map<String,String> props, Star center, double radius) Returns a VizieR catalog quries using the properties supplied to instantiate the service.
List<Star>	vizierFrom2Mass(Star center, Double radius)
List<Star>	vizierFromAscc(Star center, Double radius) Queries a field-of-view around a central star using the all-sky compiled catalog (Kharchenko 2001).
List<Star>	vizierFromBSC(Star center, Double radius) Queries a field-of-view around a central star using the Bright Star Catalogue.
List<Star>	vizierFromGsc(Star center, Double radius) Queries a fieled-of-view around a central star using the GSC 1.2 catalog.
List<Star>	vizierFromGsc2(Star center, Double radius) Queries a fieled-of-view around a central star using the GSC 2.2 catalog.
List<Star>	vizierFromHipparchos(Star center, Double radius) Queries a fieled-of-view around a central star using the Hipparchos catalog.
List<Star>	vizierFromPPMX(Star center, Double radius) Queries a field-of-view around a central star using the UCAC2-catalog.
List<Star>	vizierFromPPMXL(Star center, Double radius) Queries a field-of-view around a central star using the UCAC2-catalog.
List<Star>	vizierFromTycho2(Star center, Double radius) Queries a field-of-view around a central star using the Tycho2 catalog (Hog 2000).
List<Star>	vizierFromTycho2Supp(Star center, Double radius) Queries a field-of-view around a central star using the Tycho2 catalog (Hog 2000) plus its first supplement.
List<Star>	vizierFromUCAC2(Star center, Double radius) Queries a field-of-view around a central star using the UCAC2-catalog.
List<Star>	vizierFromUCAC3(Star center, Double radius) Queries a field-of-view around a central star using the UCAC3catalog.
List<Star>	vizierFromUCAC3Complete(Star center, Double radius) Queries a field-of-view around a central star using the UCAC3 catalog and adds all from the bright star supplement catalog.
List<Star>	vizierFromUCAC5(Star center, Double radius) Queries a field-of-view around a central star using the UCAC2-catalog.
List<Star>	vizierFromUCACSupplement(Star center, Double rad) Queries a field-of-view around a central star using the UCAC2 bright-star supplement.
private List<Star>	vizierRetrieve(VizierStarParser vizier, Star center, double radius) Normal access to vizier service if local VM can read its class loader and has unlimited access to the internet.

Methods inherited from class java.lang.Object

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

Field Detail

r

private static Resolver r

Singleton instance.

HIPPSTARRESOURCE

private static final String HIPPSTARRESOURCE

The resource name for serialized hipparchos star catalog.

See Also:

Constant Field Values

BRIGHTSTARRESOURCE

private static final String BRIGHTSTARRESOURCE

The resource name for serialized bright star catalog.

See Also:

Constant Field Values

BRIGHTESTSTARRESOURCE

private static final String BRIGHTESTSTARRESOURCE

The resource name for serialized bright star catalog.

See Also:

Constant Field Values

brighteststars

private URL brighteststars

The URL for the serialized brightes star catalog.

brightstars

private URL brightstars

The URL for the serialized bright star catalog.

hippstars

private URL hippstars

The URL for the serialized Hipparchos star catalog.

remote

private final boolean remote

The class loader used for resolving local resources cannot be accessed.

servlet

private final boolean servlet

Do not bother with DB, use servlet.

REMOTESESAME

private static final String REMOTESESAME

The Sesama servlet URL.

See Also:

Constant Field Values

REMOTEVIZIER

private static final String REMOTEVIZIER

The Vizier servlet URL.

See Also:

Constant Field Values

REMOTEDB

private static final String REMOTEDB

The db-servlet.

See Also:

Constant Field Values

NAMEPRIORITY

private static final List<String> NAMEPRIORITY

A priority list for star names.

Constructor Detail

Resolver

private Resolver(boolean onlyservlet)

To catch malformed URL's, we initialize here the bright star catalog and the brightst star catalog serialized URL's.

Method Detail

applyClassLoader

public void applyClassLoader(ClassLoader c)

Parameters:

c -

getInstance

public static Resolver getInstance()

getInstance

public static Resolver getInstance(boolean servlet)

resolveSimbad

public Star resolveSimbad(String name)

Queries the SIMBAD service using their AXIS protocol. The only thing retrievable from this query is the position of the object. Uses the name queried as the target name.

resolveSimbad

public Star resolveSimbad(String name,
                          boolean common)

Queries the SIMBAD service using their AXIS protocol. The only thing retrievable from this query is the position of the object. If the common flag is true, the common name as retrieved by the simbad query is used as the target name, otherwise the query-name is inserted.

resolveServlet

private Star resolveServlet(String name,
                            boolean common)

In VM, where the class loader cannot be read (unsigned applets), we rely instead on a servlet running on #REMOTEURL to which we pass the name and the common parameter. This servlet than does the Simbad query and returns the star description in an object stream.

Parameters:

name - A Simbad-resolvable name

common - If true, the name is deduced from Simbad aliases.

Returns:

A non-null, but maybe invalid star

resolveSesame

private Star resolveSesame(String name,
                           boolean common)

We use the normal Sesame-resolving service based on axis protocols. This requires that the class loader can be read in one of the external jars.

Parameters:

name - A Simbad-resolvable name

common - If true, the name is deduced from Simbad aliases.

Returns:

A non-null, but maybe invalid star

vizierFrom2Mass

public List<Star> vizierFrom2Mass(Star center,
                                  Double radius)

vizierFromPPMX

public List<Star> vizierFromPPMX(Star center,
                                 Double radius)

Queries a field-of-view around a central star using the UCAC2-catalog.

vizierFromPPMXL

public List<Star> vizierFromPPMXL(Star center,
                                  Double radius)

Queries a field-of-view around a central star using the UCAC2-catalog.

vizierFromUCAC3

public List<Star> vizierFromUCAC3(Star center,
                                  Double radius)

Queries a field-of-view around a central star using the UCAC3catalog.

vizierFromUCAC3Complete

public List<Star> vizierFromUCAC3Complete(Star center,
                                          Double radius)

Queries a field-of-view around a central star using the UCAC3 catalog and adds all from the bright star supplement catalog.

vizierFromUCAC5

public List<Star> vizierFromUCAC5(Star center,
                                  Double radius)

Queries a field-of-view around a central star using the UCAC2-catalog.

vizierFromUCAC2

public List<Star> vizierFromUCAC2(Star center,
                                  Double radius)

Queries a field-of-view around a central star using the UCAC2-catalog.

vizierFromBSC

public List<Star> vizierFromBSC(Star center,
                                Double radius)

Queries a field-of-view around a central star using the Bright Star Catalogue.

vizierFromUCACSupplement

public List<Star> vizierFromUCACSupplement(Star center,
                                           Double rad)

Queries a field-of-view around a central star using the UCAC2 bright-star supplement.

vizierFromHipparchos

public List<Star> vizierFromHipparchos(Star center,
                                       Double radius)

Queries a fieled-of-view around a central star using the Hipparchos catalog.

vizierFromGsc

public List<Star> vizierFromGsc(Star center,
                                Double radius)

Queries a fieled-of-view around a central star using the GSC 1.2 catalog.

vizierFromGsc2

public List<Star> vizierFromGsc2(Star center,
                                 Double radius)

Queries a fieled-of-view around a central star using the GSC 2.2 catalog.

vizierFromAscc

public List<Star> vizierFromAscc(Star center,
                                 Double radius)

Queries a field-of-view around a central star using the all-sky compiled catalog (Kharchenko 2001).

vizierFromTycho2

public List<Star> vizierFromTycho2(Star center,
                                   Double radius)

Queries a field-of-view around a central star using the Tycho2 catalog (Hog 2000).

vizierFromTycho2Supp

public List<Star> vizierFromTycho2Supp(Star center,
                                       Double radius)

Queries a field-of-view around a central star using the Tycho2 catalog (Hog 2000) plus its first supplement.

databaseFromPpmXl

public List<Star> databaseFromPpmXl(Star center,
                                    Double radius)

Queries a field-of-view around a central star using the UCAC2 plus Supplement merged database on furmint.

isRemote

public boolean isRemote()

databaseFromPpmXlFaint

public List<Star> databaseFromPpmXlFaint(Star center,
                                         Double radius)

Queries a field-of-view around a central star using the UCAC2 plus Supplement merged database on furmint.

serializedFromBrightestStars

public List<Star> serializedFromBrightestStars(Star center,
                                               Double radius)

Queries the serialized version of the brightest-star catalog.

serializedFromBSC

public List<Star> serializedFromBSC(Star center,
                                    Double radius)

Queries the serialized version of the bright star catalog.

serializedFromHipparchos

public List<Star> serializedFromHipparchos(Star center,
                                           Double radius)

Queries the serialized version of the bright star catalog.

emptyList

public List<Star> emptyList(Star center,
                            Double radius)

Returns an empty list. An escape pod for method look-up.

vizierFoV

private List<Star> vizierFoV(Map<String,String> props,
                             Star center,
                             double radius)

Returns a VizieR catalog quries using the properties supplied to instantiate the service.

vizierRetrieve

private List<Star> vizierRetrieve(VizierStarParser vizier,
                                  Star center,
                                  double radius)

Normal access to vizier service if local VM can read its class loader and has unlimited access to the internet.

Parameters:

vizier -

center - Position of the center for the field of view reolving.

radius - Radius of the FoV in degrees.

Returns:

The list of stars from the specified catalog.

servletDataBase

private List<Star> servletDataBase(Star center,
                                   double radiusdeg)

servletRetrieve

private List<Star> servletRetrieve(VizierStarParser vizier,
                                   Star center,
                                   double radius)

serializedFoV

private List<Star> serializedFoV(URL catalog,
                                 Star center,
                                 double radius)

Deserializes a SimpleStar list from the given URL and returns all stars within the radius around the center given. This method should only be used with catalogs having not more then, say, 10000 entries, but it allows really big fields that normally fail in VizieR.