Starting jskycat

Running the JSkycat application

On any Java platform you can start jskycat from the command line as follows:

java javaOptions -jar jsky.jar imageFileOrUrl jskycatOptions...

Java Options:

-Xmx128m Java option, sets the maximum amount of memory that can be used by the application. It is a good idea to include this if you are viewing many or large images, since the default setting is quite low.

-Xms20m Another Java option, this sets the initial stack size and might improve startup performance.

JSkycat Options:

-internalframes Use a Windows style desktop with internal frames

-nointernalframes Don't use internal frames

imageFileOrUrl Display the given image file

Any changes you make in the application, such as configuring the catalog plot symbols or resizing windows, are stored in the ~/.jsky directory ("Documents and Settings\username\.jsky" under Windows2000).
This directory also is used to cache image files downloaded from an image server. Clearing the history menu in the image window will empty the cache.

Example:

The following command will start jskycat:

java -jar jsky.jar

However, it is usually a good idea to give the virtual machine more memory to work with, so it is better to use the following:

java -Xmx128m -Xms20m -jar jsky.jar

To view a given image file on startup:

java -Xmx128m -Xms20m -jar jsky.jar myFile.fits

To use the internal frames version under UNIX:

java -Xmx128m -Xms20m -jar jsky.jar myFile.fits -internalframes

Java Options:
`-Xmx128m`	Java option, sets the maximum amount of memory that can be used by the application. It is a good idea to include this if you are viewing many or large images, since the default setting is quite low.
`-Xms20m`	Another Java option, this sets the initial stack size and might improve startup performance.
JSkycat Options:
`-internalframes`	Use a Windows style desktop with internal frames
`-nointernalframes`	Don't use internal frames
`imageFileOrUrl`	Display the given image file