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.
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
Option | Contents |
|
-arg | Image examination (parameter setting by argument) | *1 |
-batch | Image examination (parameter setting by batch mode) | *1 |
-console | Image examination (parameter setting by Q&A mode) | *1 |
-diff | Difference | *1 |
-identify | Identification | *2 |
-report | Output magnitude report | *2 |
-review | Reveiw of the examination result | *2 |
-survey | New object selection | *2 |
-test | Test |
|
-update | Magnitude database registration | *2 |
*1 PXF file is created.
*2 Processed based on a PXF file.
|
|
Descriptions
-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.
|
-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
|
|
-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
|
|
-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.
|
-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.
|
-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.
|
-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.
|
-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 " ".
|
-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.
detect | Test of star detection |
matching | Test of matching |
When running the test, the user has to set parameters in Q&amd;A style as same as running with -console option.
|
-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
-mxmemory volume
-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
|