MISAO Project

Japanese version       Home Page       Updated on April 2, 2000

    Running PIXY    

Here describes the options of the PIXY system. Please read Input Parameters for definite parameters. If you are a beginner, please read Tutorial.

    Running the PIXY system    

Type as follows and run the PIXY system.

java   misao.pixy.Pixy
Running the system with no options, the list of acceptable options is output.

If the PIXY system cannot run, please read Install again and check if the JDK is installed properly, the CLASSPATH is set properly, etc.

If JRE(Java Runtime Environment) is installed, the directory where the package is unpacked must be set by an option -cp. Then, type as follows and run the PIXY system (the example is in case the package is unpacked at C:\).

java   -cp   C:\   misao.pixy.Pixy

    Index of Options    

OptionContents
-argImage examination (parameter setting by argument)*1
-batchImage examination (parameter setting by batch mode)*1
-consoleImage examination (parameter setting by Q&A mode)*1
-diffDifference*1
-identifyIdentification*2
-reportOutput magnitude report*2
-reviewReveiw of the examination result*2
-surveyNew object selection*2
-testTest
-updateMagnitude database registration*2

*1 PXF file is created.
*2 Processed based on a PXF file.

    Descriptions    

o -arg     parameter     ...

Image examination (parameter setting by argument)

One of the ways to run the PIXY system for image examination and create a PXF file. Set Input Parameters in arguments. Syntax of a parameter is "key=value" and the parameters are put in a line separating by a space character.

When examining the sample image in Tutorial using -arg option, run the system as follows. In case of such parameters containing space characters in value as apprximate position of the center, enclose the whole value with " ".

java   misao.pixy.Pixy   -arg   image=sample.fts   catalog=cdrom.gsc11   catalog_path=D:\   center="11 48 0 +48 0 0"   field_of_view=1   reject_CR=Y   pxf=sample.pxf

* In one line actually.

o -batch     batch file

Image examination (parameter setting by batch mode)

One of the ways to run the PIXY system for image examination and create a PXF file. Write all Input Parameters in a batch file in advance, and run the system with the bath file. The extension of a batch file is .bat.

The syntax of parameter is "key=value" in a batch file. One parameter for on line. Separating by an empty line, the system can examine several images at one time. After the second image, parameters can be omitted if the value is same as before. The line beginning with "#" or ";" is regarded as a comment and ignored.

When examining the sample image in Tutorial using -batch option, the batch file is as follows. Here the image is examined twice, using the GSC 1.1 at first time, and using the USNO-A1.0 at second time.

# Examination using GSC 1.1
image=sample.fts
catalog=cdrom.gsc11
catalog_path=D:\
center=11 48 0 +48 0 0
field_of_view=1
reject_CR=Y
pxf=sample-gsc.pxf

; Examination using USNO-A1.0
catalog=cdrom.usnoa10
catalog_path=E:\
pxf=sample-usno.pxf
Saving this batch file with a name sample.bat, run the PIXY system as follows.
java   misao.pixy.Pixy   -batch   sample.bat

o -console

Image examination (parameter setting by Q&A mode)

One of the ways to run the PIXY system for image examination and create a PXF file. Set Input Parameters in Q&A style. For details about questions and answers, please read Input Parameters.

Running the PIXY system as follows, parameter setting in the Q&A style begins.

java   misao.pixy.Pixy   -console

o -diff     image file 1     image file 2     PXF file     log file

Difference

Comparing two images directly, it picks up new objects, variable objects and moving objects. Without star catalogs such GSC or USNO-A2.0, it can run the process only with two images of the same area.

The results are recorded in the PXF file and the log file. The file names can be omitted if you do not want to make them

Here are available options after -diff option:

  • -auto
    The result window will be closed automatically and the process will be terminated.
  • -checkimage
    The thumbnail images for confirmation are created for each differential stars. The images are created in the folder whose name is same as the PXF file.
  • -checkgallery
    One fits image containing all thumbnail images for confirmation of differential stars is created. The filename will be same as the PXF file.
  • -noPS
    It suppress to record non-differential stars data into the PXF file.

o -identify     PXF file     check file

Identification

Based on a PXF file created by the PIXY system, it identifies detected stars with known variable stars. The results are recorded in the same PXF file. The identification check list is output to the display and into the check file for inspection of the result, the list of identified stars with position difference, and the double identified stars list. The extension of the check file is .icl. When omitting the check file name, the check list is only output to the display.

Supported catalogs for identification is in Reference Catalogs. In order to run the identification, the user must construct the identification database in advance. For details, please read Identification Database Construction.

The identification database is constructed under the MISAO home directory. When running the identification, the user must set the MISAO home directory to the system property misao.home, using -D option of java command definitely. If the MISAO home directory is C:\misao for example, run the identification as follows (assuming the name of PXF file as sample.pxf):

java   -Dmisao.home=C:\misao   misao.pixy.Pixy   -identify   sample.pxf

* In one line actually.

Here are available options after -identify option:

  • -batch     batch file
    It is for identification of several PXF files at one time. In the batch file, the names of PXF files should be written, one filename for one line.
  • -noNR
    It supresses to record variable stars data which are not detected but in the frame.

o -report     PXF file     report file

Output magnitude report

Based on a PXF file created by the PIXY system, it outputs the report of magnitude estimated by the PIXY system.

The result is output to standard output. When the report file is not omitted, the result is also saved in the file.

o -review     PXF file     image file

Reveiw of the examination result

Based on a PXF file created by the PIXY system, it reviews the window situation after the examination.

The image filename can be omitted. When omitted, the system searches the image file recorded in the PXF file, in the path recorded in the PXF file or in the current path.

o -survey     folder     output file

New object selection

It selects the candidates of new objects from PXF file created by the PIXY system.

All PXF files of images taken at one night have to be put in one folder. The name of the folder is to be noted after -survey option. The result is output to standard output. When the output file is not omitted, the result is also saved in the file.

Here are available options after -survey option:

  • -pxf     paths
    The paths where PXF files of old images are saved. When setting several paths at one time, please quote them with " ".

o -test     item

Test

This is an option for test of the PIXY system. The user will never use this option usually.

The items of test are as follows.

detectTest of star detection
matchingTest of matching
When running the test, the user has to set parameters in Q&amd;A style as same as running with -console option.

o -update     PXF file

Magnitude database registration

Based on a PXF file created by the PIXY system, it registers estimated magnitude into the magnitude database.

Here are available options after -update option:

  • -batch     batch file
    It is for registration data in several PXF files at one time. In the batch file, the names of PXF files should be written, one filename for one line.
  • -image     image name
    It is for modification of image name to be recorded in the database. When omitted, the name recorded in the PXF file is used.
  • -remove
    It is to remove data of the PXF file in the magnitude database.

    JVM's Options    

o -mxmemory volume

o -ossmemory volume

The PIXY system requires much memory. So please set the memory volume for JVM properly using -mx and -oss options of java command. The volume should be a bit smaller than total memory of your machine. For example, if your machines has 64MB memory, setting 50MB is proper. Then run the PIXY system as follows. Do not enter any space characters between options and values.
java   -mx50m   -oss50m   misao.pixy.Pixy

PIXY System Home Page

Copyright(C) MISAO Project (comet@aerith.net). All rights reserved.