| qpgapmap | xray.xdataio | qpgapmap |
qpgapmap -- Calculate the de-gapped HRI coordinates (detx,dety)
qpgapmap input_list region qpoe eventdef
qpgapmap calculates the de-gapped HRI coordinates (detx,dety) by applying the gapmap to the raw telemetry coordinates (rawx,rawy).
The coordinates are corrected for all non-uniformities in the raw detector readout. The output (detx,dety) are intended to be in the same coordinates as the charged particle maps.
The region descriptor. If null is input, the entire field is copied (subject to the qpoe filters specified with the input file name). Otherwise only those photons are copied which pass the spatial region filter.
The output qpoe file name. The file must have a ".qp" extension, but may be specified with or without the extension. The output file can be the same as the input file.
The default of "full" represents the following event definition:
"{s:x,s:y,s:pha,s:pi,d:time,s:rawx,s:rawy,s:detx,s:dety,s:status}"
The PLIO mask containing exposure information for the specified source image. If the null string is input, the name will be the same root as the source image file with a "_exp.pl" extension. If "NONE" is input, no exposure filtering is performed.
The percentage of total exposure required for a given source pixel to pass the exposure filter, (if an exposure mask is present). For example, if expthresh is 50.0, then only pixels whose exposure time is >= 50% will be used. An exposure threshold of 0% allows all photons to pass the exposure filter.
Name of gapmap file
Name of output detector x coordinate
Name of input raw x coordinate
Name of input raw y coordinate
Name of input pha coordinate
Apply random number continuity correction, this should not be changed.
X offset to apply after degapping
Y offset to apply after degapping
Boolean flag specifying whether or not the qpoe file can be overwritten, if it already exists.
The display level. A display level of 0 generates no display. A display level of 1 generates a display of header information.
Flag if events are to be sorted. If true, the type of sort is determined by the sorttype parameter.
The type of sort to perform. This string consists of a list of event element names that specifies the order in which to sort the event record. For example, "y x time" will sort on the "y" element as the primary key, the "x" element as the secondary key, and "time" as the tertiary key. If sorting is not to be performed, this parameter can be used as a string that will go into the x_sort qpoe param to indicate the type of sorting of the events. For example, if the events are already sorted by time, and are not to be resorted, one can set sort to false and sorttype to "time", and the qpoe file will be indistinguishable from one whose events were sorted by time.
The number of bytes that are to be sorted at a time. This allows users to tailor the task to the amount of available memory. If there is a lot of memory available, sortsize should be set large enough so that the task will do an in-core sort. (This requires knowing the approximate number of events and the byte size of each event.) If only a small amount of memory is available, use a smaller number. In this case, several core loads will be sorted and written to temp files, which are then merged.
Boolean flag controlling whether the internal qpoe parameters (see below) are prompted for, or whether they are defaulted to internally hardwired values. This parameter is not usually changed by the user. (Prompting is normally turned off during stand-alone debugging only.)
Page size for the qpoe file. This parameter is internal to qpoe and should not normally be changed.
Bucket length for the qpoe file. This parameter is internal to qpoe and should not normally be changed.
The default block factor for IMIO. This parameter is internal to qpoe and should not normally be changed.
Boolean flag that an index should be made for the qpoe file. This parameter is internal to qpoe and should not normally be changed.
Key on which to make the qpoe index. This parameter is internal to qpoe and should not normally be changed.
Debug level for qpoe internals. This parameter is internal to qpoe and should not normally be changed.
1. Apply the gapmap to the HRI Arlac Qpoe
xp> qpgapmap input qpoe filename: xdata$rh110267n00.qp region descriptor: output qpoe file name: harlac event definition (full): phamean: 4.6679964 xphacorr -0.2630998 0.0019947 0.0439791 0.0017134 -0.3353015 0.0013023 yphacorr -0.0493336 0.0011228 0.0269875 0.0014226 -0.1370220 0.0014607 xdata$rh110267n00.qp (; no exp.; gapmap=xspatialdata$283cgapmap4.ieee) -> harlac.qp Creating QPOE output file: harlac.qp
Documentation on region filtering (help regions ) for a description of the spatial filter user interface.
Documentation on qpoe filtering (help qpoe ) for a description of the qpoe filter user interface.
Documentation on coordinates (help coords ) for a description of PROS coordinate conventions.