STScI Logo

qphedit xray.ximages


NAME · USAGE · DESCRIPTION · PARAMETERS · EXAMPLES · BUGS · SEE_ALSO

NAME

qphedit - edit or view one or more qpoe headers

USAGE

qphedit qpoe fields value

DESCRIPTION

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.

PARAMETERS

qpoe = prompt = qpoe(s) to be edited

Template specifying the qpoe files to be edited.

fields = prompt = fields to be edited

The field (header keyword) to be edited in each qpoe file.

value = prompt = value expression

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.

(add = no) [boolean]

Change the operation of the editor from update to add new field.

(delete = no) [boolean]

Change the operation of the editor from update to delete field. The listed field is deleted from each qpoe file.

(verify = yes) [boolean]

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.

(show = yes) [boolean]

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.

(update = yes) [boolean]

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.

EXAMPLES

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

BUGS

This task does not handle compound header parameters, such as the tgr data. Do not try to display or edit this data using qphedit.

SEE ALSO

wcsqpedit

hedit


Source Code · Search Form · STSDAS