DigitizedSkySurveyImage

java.lang.Object
- util.PropertyContainer
- - net.DigitizedSkySurveyImage

All Implemented Interfaces:

Cloneable, PropertySupplying

Deprecated.
Use DigitizedSkySurvey instead.
```
@Deprecated
public class DigitizedSkySurveyImage
extends PropertyContainer
```
This class uses a cgi-based interface to the dss server to retrieve a dss image readily to use as a Java-image. The standard retrieval format is on an URL like http://stdatu.stsci.edu/cgi-bin/dss_search?v=poss2ukstu&r=16+00+00&d=-20+00+00&e=J2000&h=15.0&w=15.0&f=gif&s=true&c=none&fov=NONE&v3= . As I know only how to operate this server, the extra-work involved in allowing the user to specify the server KEY_SERVER, the CGI-path KEY_CGIPATH and all the id's for the necessary fields might be extra work, but future development may provide different servers. Note that the user can specify the name of the method that actually transfers a request to the server with the KEY_URLMETHOD key. Actually, it points to getUrlForStsci(java.lang.Double, java.lang.Double, java.lang.Double, java.lang.Double). Additional implementation should adopt a similar naming scheme, i.e. starting with getUrlFor extended with the institute name providing the service. This method must always return an URL and must be declared in this class.
New locations
- http://dss.nao.ac.jp/wide_field/servlet/FITSImage?src=Digitized+Sky+ Survey+1st&ra=3+47+0.0&dec=%2B24+7+4.5776367E-4&dra=180&ddec=180&pix=&mode= Transgress+plate (added 22.02.2005, implementation pending)

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class DigitizedSkySurveyImage.Display
Deprecated.

Test the image retrieval.

Nested Classes
Modifier and Type	Class and Description
`static class`	`DigitizedSkySurveyImage.Display` Deprecated. Test the image retrieval.

Field Summary

Fields
Modifier and Type	Field and Description
`private static String`	`DEFCGIPATH` Deprecated. Default print writer to use for the syslog.
`private static String`	`DEFIDDEC` Deprecated. Default print writer to use for the syslog.
`private static String`	`DEFIDEPOCH` Deprecated. Default print writer to use for the syslog.
`private static String`	`DEFIDFORMAT` Deprecated. Default print writer to use for the syslog.
`private static String`	`DEFIDHEIGHT` Deprecated. Default print writer to use for the syslog.
`private static String`	`DEFIDRA` Deprecated. Default print writer to use for the syslog.
`private static String`	`DEFIDSOURCE` Deprecated. Default print writer to use for the syslog.
`private static String`	`DEFIDWIDTH` Deprecated. Default print writer to use for the syslog.
`private static String`	`DEFPROTOCOL` Deprecated. Default print writer to use for the syslog.
`private static String`	`DEFSERVER` Deprecated. Default print writer to use for the syslog.
`private static String`	`DEFURLMETHOD` Deprecated. Default print writer to use for the syslog.
`private static Toolkit`	`imageload` Deprecated. The ttolkit for downloading URL's to images.
`static String`	`KEY_CGIPATH` Deprecated. The cgi-path after the server name.
`static String`	`KEY_IDDEC` Deprecated. The string used to identify the declination of the image.
`static String`	`KEY_IDEPOCH` Deprecated. The string used to identify the epoch of the position.
`static String`	`KEY_IDFORMAT` Deprecated. The string used to identify the image format.
`static String`	`KEY_IDHEIGHT` Deprecated. The string used to identify the height of the image.
`static String`	`KEY_IDRA` Deprecated. The string used to identify the right ascension of the image.
`static String`	`KEY_IDSOURCE` Deprecated. The string used to identify the plate source.
`static String`	`KEY_IDWIDTH` Deprecated. The string used to identify the width of the image.
`static String`	`KEY_PROTOCOL` Deprecated. The protocol type for downloading.
`static String`	`KEY_SERVER` Deprecated. The server name hosting the digitized sky survey archive.
`static String`	`KEY_URLMETHOD` Deprecated. This method is called to retrieve an URL for image download.

Fields inherited from class util.PropertyContainer
KEY_LISTSEPARATOR, KEY_MAPKEYVALUECHAR, KEY_MAPSEPARATOR

Fields inherited from interface util.PropertySupplying
CONFIG, KEY_CLASS

Constructor Summary

Constructors
Constructor and Description

DigitizedSkySurveyImage(Map<String,String> prop)
Deprecated.

Constructs a new dss-image retrieval object.

Constructors
Constructor and Description
`DigitizedSkySurveyImage(Map<String,String> prop)` Deprecated. Constructs a new dss-image retrieval object.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`private URL`	`getDownloadUrl(double ra, double dec, double width, double height)` Deprecated. Returns the URL from which the image can be retrieved.
`Image`	`getImage(double ra, double dec, double width, double height)` Deprecated. Takes the center of an image, its width and height and retrieves it from a dss server.
`Image`	`getImageAndWait(Component forme, double ra, double dec, double width, double height)` Deprecated. Takes the center of an image, its width and height and retrieves it from a dss server.
`private static String`	`getMinSec(double degree)` Deprecated. Converts the fractional part of the argument into minutes and seconds.
`URL`	`getUrlForStsci(Double ra, Double dec, Double width, Double height)` Deprecated. This method prepares an url according to the CGI-requirements of the STScI dss-server.

Methods inherited from class util.PropertyContainer
augment, augment, augment, augment, augment, clone, defaultBoolean, defaultChar, defaultDouble, defaultFloat, defaultInt, defaultLong, defaultObject, defaultObject, defaultProperties, defaultProperty, getAsBoolean, getAsChar, getAsDouble, getAsEnums, getAsFloat, getAsInt, getAsList, getAsLong, getAsMap, getAsMap, getAsObject, getAsObject, getProperties, getProperty, has, initProperties, isNew, parseObject, parseObject, reload, reload, removeProperty, requires, rescanned, setObject, setProperties, setProperty, stringProperties, toString

Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - KEY_PROTOCOL
```
public static final String KEY_PROTOCOL
```
    Deprecated.
    
    The protocol type for downloading.
    
    See Also:
    
    Constant Field Values
  - KEY_SERVER
```
public static final String KEY_SERVER
```
    Deprecated.
    
    The server name hosting the digitized sky survey archive.
    
    See Also:
    
    Constant Field Values
  - KEY_CGIPATH
```
public static final String KEY_CGIPATH
```
    Deprecated.
    
    The cgi-path after the server name.
    
    See Also:
    
    Constant Field Values
  - KEY_IDSOURCE
```
public static final String KEY_IDSOURCE
```
    Deprecated.
    
    The string used to identify the plate source.
    
    See Also:
    
    Constant Field Values
  - KEY_IDRA
```
public static final String KEY_IDRA
```
    Deprecated.
    
    The string used to identify the right ascension of the image.
    
    See Also:
    
    Constant Field Values
  - KEY_IDDEC
```
public static final String KEY_IDDEC
```
    Deprecated.
    
    The string used to identify the declination of the image.
    
    See Also:
    
    Constant Field Values
  - KEY_IDEPOCH
```
public static final String KEY_IDEPOCH
```
    Deprecated.
    
    The string used to identify the epoch of the position.
    
    See Also:
    
    Constant Field Values
  - KEY_IDHEIGHT
```
public static final String KEY_IDHEIGHT
```
    Deprecated.
    
    The string used to identify the height of the image.
    
    See Also:
    
    Constant Field Values
  - KEY_IDWIDTH
```
public static final String KEY_IDWIDTH
```
    Deprecated.
    
    The string used to identify the width of the image.
    
    See Also:
    
    Constant Field Values
  - KEY_IDFORMAT
```
public static final String KEY_IDFORMAT
```
    Deprecated.
    
    The string used to identify the image format.
    
    See Also:
    
    Constant Field Values
  - KEY_URLMETHOD
```
public static final String KEY_URLMETHOD
```
    Deprecated.
    
    This method is called to retrieve an URL for image download.
    
    See Also:
    
    Constant Field Values
  - DEFPROTOCOL
```
private static final String DEFPROTOCOL
```
    Deprecated.
    
    Default print writer to use for the syslog.
    
    See Also:
    
    Constant Field Values
  - DEFSERVER
```
private static final String DEFSERVER
```
    Deprecated.
    
    Default print writer to use for the syslog.
    
    See Also:
    
    Constant Field Values
  - DEFCGIPATH
```
private static final String DEFCGIPATH
```
    Deprecated.
    
    Default print writer to use for the syslog.
    
    See Also:
    
    Constant Field Values
  - DEFIDSOURCE
```
private static final String DEFIDSOURCE
```
    Deprecated.
    
    Default print writer to use for the syslog.
    
    See Also:
    
    Constant Field Values
  - DEFIDRA
```
private static final String DEFIDRA
```
    Deprecated.
    
    Default print writer to use for the syslog.
    
    See Also:
    
    Constant Field Values
  - DEFIDDEC
```
private static final String DEFIDDEC
```
    Deprecated.
    
    Default print writer to use for the syslog.
    
    See Also:
    
    Constant Field Values
  - DEFIDEPOCH
```
private static final String DEFIDEPOCH
```
    Deprecated.
    
    Default print writer to use for the syslog.
    
    See Also:
    
    Constant Field Values
  - DEFIDHEIGHT
```
private static final String DEFIDHEIGHT
```
    Deprecated.
    
    Default print writer to use for the syslog.
    
    See Also:
    
    Constant Field Values
  - DEFIDWIDTH
```
private static final String DEFIDWIDTH
```
    Deprecated.
    
    Default print writer to use for the syslog.
    
    See Also:
    
    Constant Field Values
  - DEFIDFORMAT
```
private static final String DEFIDFORMAT
```
    Deprecated.
    
    Default print writer to use for the syslog.
    
    See Also:
    
    Constant Field Values
  - DEFURLMETHOD
```
private static final String DEFURLMETHOD
```
    Deprecated.
    
    Default print writer to use for the syslog.
    
    See Also:
    
    Constant Field Values
  - imageload
```
private static final Toolkit imageload
```
    Deprecated.
    
    The ttolkit for downloading URL's to images.
- Constructor Detail
  - DigitizedSkySurveyImage
```
public DigitizedSkySurveyImage(Map<String,String> prop)
```
    Deprecated.
    
    Constructs a new dss-image retrieval object. After construction, multiple images can be retrieved using the getImage(double, double, double, double) method.
- Method Detail
  - getImage
```
public Image getImage(double ra,
                      double dec,
                      double width,
                      double height)
```
    Deprecated.
    
    Takes the center of an image, its width and height and retrieves it from a dss server. This method relies on the Toolkit.createImage(URL) method, thus returning fast, but delivering a maybe not fully retrieved image. If you want to wait until the image has been transfered completely, use getImageAndWait(java.awt.Component, double, double, double, double).
    
    Parameters:
    
    ra - Right ascension of the center of the image in degrees.
    
    dec - Declination of the center of the image in degrees.
    
    width - Width of the image in degrees.
    
    height - Height of the image in degrees.
    
    Returns:
    
    A possibly not fully fetched sky image or null.
  - getImageAndWait
```
public Image getImageAndWait(Component forme,
                             double ra,
                             double dec,
                             double width,
                             double height)
```
    Deprecated.
    
    Takes the center of an image, its width and height and retrieves it from a dss server. This method uses a media tracker to wait until the image is fully retrieved. If you do not want to wait until the image has been transfered completely, use getImage(double, double, double, double).
    
    Parameters:
    
    forme - The component that wants to display the image.
    
    ra - Right ascension of the center of the image in degrees.
    
    dec - Declination of the center of the image in degrees.
    
    width - Width of the image in degrees.
    
    height - Height of the image in degrees.
    
    Returns:
    
    A fully fetched sky image or null.
  - getDownloadUrl
```
private URL getDownloadUrl(double ra,
                           double dec,
                           double width,
                           double height)
```
    Deprecated.
    
    Returns the URL from which the image can be retrieved. This method uses the KEY_URLMETHOD property to fork into the appropriate method.
    
    Parameters:
    
    ra - Right ascension of the center of the image in degrees.
    
    dec - Declination of the center of the image in degrees.
    
    width - Width of the image in degrees.
    
    height - Height of the image in degrees.
  - getMinSec
```
private static final String getMinSec(double degree)
```
    Deprecated.
    
    Converts the fractional part of the argument into minutes and seconds. Returns a string ready for a cgi-query.
  - getUrlForStsci
```
public URL getUrlForStsci(Double ra,
                          Double dec,
                          Double width,
                          Double height)
```
    Deprecated.
    
    This method prepares an url according to the CGI-requirements of the STScI dss-server. In particular, an URL is created from a string similar to http://stdatu.stsci.edu/cgi-bin/dss_search?v=poss2ukstu&r=16+00+00& d=-20+00+00&e=J2000&h=15.0&w=15.0&f=gif&s=true&c=none&fov=NONE&v3=. Here, poss2ukstu is the default KEY_IDSOURCE of the image, r is right ascension in hours, minutes and seconds, d the declination in degrees, minutes and seconds separated with '+' that replace ' '. Height and width are in arcminutes. Retrieval format is always 'gif' to allow JAVA to convert the bytes into an image. No compression, field-of-view, or rotation angle is allowed.
    The image requested has integer width and height (arcmin).

Class DigitizedSkySurveyImage

Nested Class Summary

Field Summary

Fields inherited from class util.PropertyContainer

Fields inherited from interface util.PropertySupplying

Constructor Summary

Method Summary

Methods inherited from class util.PropertyContainer

Methods inherited from class java.lang.Object

Field Detail

KEY_PROTOCOL

KEY_SERVER

KEY_CGIPATH

KEY_IDSOURCE

KEY_IDRA

KEY_IDDEC

KEY_IDEPOCH

KEY_IDHEIGHT

KEY_IDWIDTH

KEY_IDFORMAT

KEY_URLMETHOD

DEFPROTOCOL

DEFSERVER

DEFCGIPATH

DEFIDSOURCE

DEFIDRA

DEFIDDEC

DEFIDEPOCH

DEFIDHEIGHT

DEFIDWIDTH

DEFIDFORMAT

DEFURLMETHOD

imageload

Constructor Detail

DigitizedSkySurveyImage

Method Detail

getImage

getImageAndWait

getDownloadUrl

getMinSec

getUrlForStsci