ShowSky

STScI ACDSD MASTCASB {•subtitle}

Products
GSC
DSS
GSPC
Science

Publications

Data Access
Related Science 
Missions
HST
GEMINI
VLT
NGST
Virtual Observatory
XMM
Facilities
Plate Scanning
COMPASS ooDB 
Staff Pages

Last Updated Jan 2001

Copyright © 2001 The Association of Universities for Research in Astronomy, Inc. All Rights Reserved.

Help

ShowSky Help

The ShowSky UserGuide describes the features of ShowSky and how to configure it this is available online as html (HTML USER GUIDE) or as a word document (WORD USER GUIDE).

For those who wish to extend ShowSky the JavaDocs will be essential these are available online (ShowSky JavaDocs online) or as a jar (ShowSky JavaDocs download) for download. If you download the jar unjar it (jar -xvf showskydoc.jar) and point your browser at the index.html file in the showskyjdocs directory. Further information is available in the user guide about extending ShowSky.

If you have problems installing and getting ShowSky to work or would like to tell us how bad or good it is please send an e-mail. But please read below first.

Common Problems and Soloutions

To find problems it is better to run showsky from the command line rather than by double clicking on the showsky.jar - this way output may be seen in the terminal window in which it is running.

P A grey box appears on the screen but nothing else.
S

This usually means the HTM has been enabled but htmIndex.jar is not in the classpath. Edit stsci.properties and set HTM=false. Try again. Also check for error messages in the dos window you executed from.

P I downloaded the Jar file using save link as in Netscape and it does not work
S

It seems netscape corupts the jar files on down load. Try the ZIP.

P Everything seems fine but I see no images.
S

Perhpas the tool can not write to the temp directory. Check the ouput as the tool starts up you may see a message "Temp dir /tmp is bad". TEMP is configurable in the stsci.properties file. If TEMP is okay select a small field and DSS1 catalogue and hit view - if an error is output please send an e-mail.

P I see java.lang.ClassNotFoundException in the output.
S

This generally means something is missing from your CLASSPATH. Have htmIndex.jar and nomfits.jar been installed correctly ? Has JAI been installed correctly ?. Check which java you are executing and make sure that the /jre/lib/ext folder under the jdk directory contains the two jars mentioned above plus a few jars with the word jai in them.

Q How can I check JAI is available ?
A

At a command prompt type

javap javax.media.jai.PlanarImage

you should see a lot of text if its okay otherwise you will see class not found.

P Sources in the corners of the image are not matched.
S The images are square but the catalogue queries return a circle of objects within a certain radius of the center point.Hence the corners will not be matched. We did not want to use the diagonal radius as it would extract many more sources which would not be ploted but would appear in the star list. If you need to get the sources in the corners choose a slightly larger area.