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. |
|