Input Parameters
Here describes the key used to run the PIXY system in batch mode and the question output by the system in Q&A mode for each parameter, and the meaning of every parameter.
Please read Running PIXY for how to run the PIXY system.
|
Index of Parameters
Key | Contents |
image | Filename or URL of the image |
exposure_start | Date and time when exposure started |
exposure | Exposure time |
catalog | Star catalog used for examination |
catalog_path | Path of the star catalog |
center | Approximate R.A. and Decl. |
pos_error | Expected error of the R.A. and Decl. |
field_of_view | Approximate field of view |
limiting_mag | Limiting magnitude |
mag_code | Code attached to magnitude |
mirror | In case of a mirror image or not |
sbig_ratio | In case of an image of ST-4/6 |
reject_CR | Automatically remove cosmic rays or not |
detail | Output data in detail or not |
log | Name of log file |
pxf | Name of PXF file |
|
Descriptions
Key | image |
Question | URL or filename of image: |
Contents | Filename or URL of the image |
Input the filename or the URL of the image to be examined by the PIXY system.
Supported file format are:
FITS, MTF/BIN(*1), GIF, JPEG, PPM, PGM
In case of a FITS, MTF/BIN file, the extension of the file must be one of the following ones.
FITS | .fts, .fit, .fits |
MTF/BIN | .mtf / .bin |
*1 The class file to read MUTOH MTF/BIN file format is not public.
|
Key | exposure_start |
Question |
Exposure start date and time in UT:
ex. 1998 Jan. 31 01:23:45
acceptable style: 1998 Jan 31 01:23:45
1998 1 31 1 23 45
Exposure start date and time in UT:
|
Contents | Date and time when exposure started |
Input the data and time when exposure started in a style in the question above.
The user must input all of year, month, day, hour, minute and second.
The exposure start date and time is not used by the PIXY system actually.
It is only recorded in the PXF file.
So you can omit this parameter.
|
Key | exposure |
Question | Exposure in seconds: |
Contents | Exposure time |
Input the exposure time in such styles as "120 sec", "2 min".
Omitting the unit, it is considered as in second.
The exposure time is not used by the PIXY system actually.
It is only recorded in the PXF file.
So you can omit this parameter.
|
Key | catalog |
Question |
List of accessible star catalogs:
Code Catalog
cdrom.gsc11 [CD-ROM] Guide Star Catalog (ver. 1.1)
cdrom.usnoa10 [CD-ROM] USNO-A1.0 (V=R+0.375(B-R))
cdrom.usnoa20 [CD-ROM] USNO-A2.0 (V=R+0.375(B-R))
Input code:
|
Contents | Star catalog used for examination |
Input a code of star catalog to use for examination.
In the Q&A mode, the list of supported star catalogs is output.
So select one of the catalogs.
|
Key | catalog_path |
Question | Root directories of the catalog: |
Contents | Path of the star catalog |
Star catalogs used for examination are distributed as CD-ROMs in general.
Here input the path (or drive letter in case of Windows95) of the CD-ROM.
Several paths can be set here.
For example, when examining an image of the area around the border of two CD-ROMs of GSC 1.1, both CD-ROMs are required at the same time.
If there are two CD-ROM drives E: and F:, set both of two CD-ROMs in the drives, and input both drive letters for this parameter separating by a space character, like "E:\ F:\".
|
Key | center |
Question |
Approximate position (J2000.0):
ex. R.A.= 12h 4m31.2s Decl.= - 0o15'
acceptable style: 12 4 31.2 -0 15 0
Approximate position (J2000.0):
|
Contents | Approximate R.A. and Decl. |
Input the approximate R.A. and Decl. of the image.
The user must input all of hour, minute, second of R.A., degree, arcmin, arcsec of Decl.
The R.A. and Decl. can be that of the target or one of stars in the image.
The user does not have to input the accurate R.A. and Decl. of the center here.
|
Key | pos_error |
Question | Position error in degree: |
Contents | Expected error of the R.A. and Decl. |
Input the expected error of the approximate R.A. and Decl. of the center input above.
It can be 0 in most case.
When the target object is out of the image, or the image position is extremely uncertain, input a proper value.
Input the error in such styles as "1 deg", "30 arcmin", "120 arcsec".
Omitting the unit, it is considered as in degree.
|
Key | field_of_view |
Question | Approximate horizontal field of view in degree: |
Contents | Approximate field of view |
Input the approximate horizontal field of view.
It can be inaccurate, 20% or 30% difference can be adjusted by the system properly.
Input the field of view in such styles as "1 deg", "30 arcmin", "120 arcsec".
Omitting the unit, it is considered as in degree.
|
Key | limiting_mag |
Question | Limiting magnitude to be detected at least: |
Contents | Limiting magnitude |
Input the limiting magnitude to be detected at least.
When you would like to let the PIXY system automatically set the limiting magnitude, hit RETURN key immediately here, with no input.
In general, this parameter is used in case the PIXY system could not detect faint stars properly.
|
Key | mag_code |
Question | Magnitude code: |
Contents | Code attached to magnitude |
This parameter can be omitted usually.
When you would like to point out the image is though R filter, or the magnitude is that of a CCD image, input "R", "C" or other proper code here.
Then the code is attached to the end of all magnitude in the result, like "6.24R", "10.35C".
|
Key | mirror |
Question | Mirror image? [y/N]: |
Contents | In case of a mirror image or not |
Answer if the image is a mirror image, Y(Yes) or N(No).
Omitting here is considered "N".
|
Key | sbig_ratio |
Question | SBIG ratio (ST-4/6)? [y/N]: |
Contents | In case of an image of ST-4/6 |
Answer if the image is that of ST-4/6, Y(Yes) or N(No).
Omitting here is considered "N".
Inputting "Y" here, the ratio width : height of the image must be 1.176 : 1.
|
Key | reject_CR |
Question | Reject cosmic ray? [y/N]: |
Contents | Automatically remove cosmic rays or not |
Answer if you would like to remove the cosmic rays or white noises automatically, Y(Yes) or N(No).
Omitting here is considered "N".
When removing them automatically, some real stars may be also removed sometimes, especially in case of a very sharp image, or a GIF/JPEG image.
|
Key | detail |
Question | Print star data in detail (much memory are required)? [y/N]: |
Contents | Output data in detail or not |
Answer if you would like to print out data in detail, Y(Yes) or N(No).
Omitting here is considered "N".
When printing out data in detail, much memory are required.
|
Key | log |
Question | Filename to save midway progress (.log): |
Contents | Name of log file |
When you would like to save the midway progress, output to the display(*1), in a file, input the filename.
It can be omitted usually.
When some error happens and the examination failed, saving the midway progress will help further analisys.
The extension should be .log.
*1 The midway progress is not output to the display in batch mode.
|
Key | pxf |
Question | Filename to save results (.pxf): |
Contents | Name of PXF file |
Input a filename to save the result.
This parameter cannot be omitted because the results are not output to the display.
The extension should be .pxf.
Once a PXF file is created after examination by the PIXY system, all further processes, identification, difference, etc., are executed based on the PXF file.
So please keep the PXF file carefully.
For details of PXF file, please read PXF File Format.
|
|
PIXY System Home Page
|