About Chandra Archive Proposer Instruments & Calibration Newsletters Data Analysis HelpDesk Calibration Database NASA Archives & Centers Chandra Science Links

Skip the navigation links
Last modified: December 2006

URL: http://cxc.harvard.edu/ciao3.4/dmappend.html
Hardcopy (PDF): A4 | Letter
AHELP for CIAO 3.4 dmappend Context: tools

Synopsis

Append multiple blocks/extensions to an existing output file.

Syntax

dmappend infile outfile [verbose]

Description

The dmappend tool is a simple tool to append several related blocks/extensions to an existing output file.

Note: You cannot append a block to a file if it has the same name as a block already in the file. To see block names, use `dmlist filename blocks'. (You can circumvent this limitation by renaming the block before appending. See "ahelp dmsyntax" for details.)

Example 1

dmappend "tmp.fits[region]" evt1a.fits

Takes the block called "region" in file tmp.fits and appends it to evt1a.fits. evt1a.fits must already exist.

Example 2

dmappend "acis*.fits" output.fits

Will find all files in the current directory with names that start with "acis" and end in ".fits" and will append the first `interesting' block (see the DM documentation) from each to separate blocks in the existing output.fits file. The block names of all input files and the initial output file should be all different.

Example 3

dmappend @data.lis output.fits

Will open the text file "data.lis" and append the blocks listed in the file to the existing output file, output.fits. If "data.lis" has two lines containing dmcontreg.fits and acisf01712N002_cntr_img2.fits, and output.fits is '273_109cnts_evt2.fits'; then this event file which originally had the GTI extensions and the event list will now contain also a region file and an image extension.

Parameters

name type ftype def min max reqd stacks
infile file input       yes yes
outfile file output       yes  
verbose integer   0 0 5    

Detailed Parameter Descriptions

Parameter=infile (file required filetype=input stacks=yes)

Input file name(s).

CIAO stacks may be a single filename, a comma-delimited list of names, or '@' followed by the name of a text file containing one filename on each line. Each filename may use the full CIAO DM virtual file syntax.

For one or multiple input files, there should be only one single output file.

Parameter=outfile (file required filetype=output)

The output file name (must exist).

The output file name that must already exist. The input tables/images will be converted to format of the output file. Each input file will be appended as a separate extension/block.

Parameter=verbose (integer default=0 min=0 max=5)

display level(0-5)

Bugs

See the bugs page for this tool on the CIAO website for an up-to-date listing of known bugs.

Hardcopy (PDF): A4 | Letter
Last modified: December 2006



The Chandra X-Ray Center (CXC) is operated for NASA by the Smithsonian Astrophysical Observatory.
60 Garden Street, Cambridge, MA 02138 USA.    Email: cxcweb@head.cfa.harvard.edu
Smithsonian Institution, Copyright © 1998-2004. All rights reserved.