| qphedit | xray.ximages | qphedit |
qphedit - edit or view one or more qpoe headers
qphedit qpoe fields value
This task can be used to add, edit, delete, or view the header keywords in one or more qpoe files. This task functions similarly to the images task hedit .
Note: This task can NOT be used to edit WCS keywords in a QPOE file, such as any of the following:
CTYPE1,2
CRPIX1,2
CRVAL1,2
CDELT1,2
CD1_1,CD2_2,CD1_2,CD2_1
Use the task wcsqpedit
for these special parameters.
Template specifying the qpoe files to be edited.
The field (header keyword) to be edited in each qpoe file.
Either a string constant or a general expression (if the first character is a left parenthesis) to be evaluated to compute the new value of each field. A single expression is used for all fields. The special value "." causes the value of each field to be printed rather than edited.
Change the operation of the editor from update to add new field.
Change the operation of the editor from update to delete field. The listed field is deleted from each qpoe file.
Interactively verify all operations which modify the image database. The editor will describe the operation to be performed, prompting with the new value of the parameter in the case of a field edit. Type carriage return or "yes" to complete the operation, or enter a new value explicitly as a string. Respond with "no" if you do not wish to change the value of the parameter.
After each parameter is changed, the user will be asked if they wish to continue. Respond with "no" if you wish to change no more parameters, "yes" if you wish to continue changing parameters.
Print a record of each operation which modifies the database upon the standard output. Old values are given as well as new values, making it possible to undo an edit operation.
Enable updating of the image database. If updating is disabled the edit operations are performed in memory but image headers will not be updated on disk.
1) To add a parameter to a collection of QPOE files.
xi> dir rp*qp rp150015.qp rp600119.qp xi> qphedit add=yes images to be edited: rp*.qp fields to be edited: myfield value expression: This is a new field add rp150015.qp,myfield = "This is a new field" continue ? (yes): yes rp150015.qp updated add rp600119.qp,myfield = "This is a new field" continue ? (yes): yes rp600119.qp updated
2) To display a parameter in a collection of QPOE files.
xi> qphedit images to be edited: rp*.qp fields to be edited: myfield value expression: . rp150015.qp,myfield = "This is a new field" rp600119.qp,myfield = "This is a new field"
3) To update a parameter in a collection of QPOE files, without asking for verification.
xi> qphedit verify=no images to be edited: rp*.qp fields to be edited: myfield value expression: newer field rp150015.qp,myfield: "This is a new field" -> "newer field" rp150015.qp updated rp600119.qp,myfield: "This is a new field" -> "newer field" rp600119.qp updated
4) To update a parameter in a collection of QPOE files, with verification.
xi> qphedit
images to be edited: rp*.qp
fields to be edited: myfield
value expression: Newest field
rp150015.qp,myfield ("newer field" -> "Newest field"): yes
rp150015.qp,myfield: "newer field" -> "Newest field"
continue ? (yes):
rp150015.qp updated
rp600119.qp,myfield ("newer field" -> "Newest field"): yes
rp600119.qp,myfield: "newer field" -> "Newest field"
continue ? (yes):
rp600119.qp updated
5) To delete a parameter in a collection of QPOE files.
xi> qphedit delete=yes images to be edited: rp*.qp fields to be edited: myfield delete rp150015.qp,myfield ? (yes): rp150015.qp,myfield deleted continue ? (yes): rp150015.qp updated delete rp600119.qp,myfield ? (yes): rp600119.qp,myfield deleted continue ? (yes): rp600119.qp updated
This task does not handle compound header parameters, such as the tgr data. Do not try to display or edit this data using qphedit.