funmerge(1) [suse man page]
funmerge(1) SAORD Documentation funmerge(1) NAME
funmerge - merge one or more Funtools table files SYNOPSIS
funmerge [-w|-x] -f [colname] <iname1> <iname2> ... <oname> OPTIONS
-f # output a column specifying file from which this event came -w # adjust position values using WCS info -x # adjust position values using WCS info and save old values DESCRIPTION
funmerge merges FITS data from one or more FITS Binary Table files or raw event files. The first argument to the program specifies the first input FITS table or raw event file. If "stdin" is specified, data are read from the standard input. Use Funtools Bracket Notation to specify FITS extensions and row filters. Subsequent arguments specify additional event files and tables to merge. (NB: Stdin cannot not be used for any of these additional input file arguments.) The last argument is the out- put FITS file. The columns in each input table must be identical. If an input file begins with the '@' character, it is processed as an include file, i.e., as a text file containing event file names (as well as blank lines and/or comment lines starting with the '#' sign). If standard input is specified as an include file ('@stdin'), then file names are read from the standard input until EOF (^D). Event files and include files can be mixed on a command line. Rows from each table are written sequentially to the output file. If the switch -f [colname] is specified on the command line, an addi- tional column is added to each row containing the number of the file from which that row was taken (starting from one). In this case, the corresponding file names are stored in the header parameters having the prefix FUNFIL, i.e., FUNFIL01, FUNFIL02, etc. Using the -w switch (or -x switch as described below), funmerge also can adjust the position column values using the WCS information in each file. (By position columns, we mean the columns that the table is binned on, i.e., those columns defined by the bincols= switch, or (X,Y) by default.) To perform WCS alignment, the WCS of the first file is taken as the base WCS. Each position in subsequent files is adjusted by first converting it to the sky coordinate in its own WCS coordinate system, then by converting this sky position to the sky position of the base WCS, and finally converting back to a pixel position in the base system. Note that in order to perform WCS alignment, the appropriate WCS and TLMIN/TLMAX keywords must already exist in each FITS file. When performing WCS alignment, you can save the original positions in the output file by using the -x (for "xtra") switch instead of the -w switch (i.e., using this switch also implies using -w) The old positions are saved in columns having the same name as the original positional columns, with the added prefix "OLD_". Examples: Merge two tables, and preserve the originating file number for each row in the column called "FILE" (along with the corresponding file name in the header): [sh] funmerge -f "FILE" test.ev test2.ev merge.ev Merge two tables with WCS alignment, saving the old position values in 2 additional columns: [sh] funmerge -x test.ev test2.ev merge.ev This program only works on raw event files and binary tables. We have not yet implemented image and array merging. SEE ALSO
See funtools(7) for a list of Funtools help pages version 1.4.2 January 2, 2008 funmerge(1)
Check Out this Related Man Page
funtools(7) SAORD Documentation funtools(7) NAME
Funtools - FITS Users Need Tools SYNOPSIS
This document is the Table of Contents for Funtools. DESCRIPTION
Funtools, is a "minimal buy-in" FITS library and utility package developed at the the High Energy Astrophysics Division of SAO. The Fun- tools library provides simplified access to a wide array of file types: standard astronomical FITS images and binary tables, raw arrays and binary event lists, and even tables of ASCII column data. A sophisticated region filtering library (compatible with ds9) filters images and tables using boolean operations between geometric shapes, support world coordinates, etc. Funtools also supports advanced capabilities such as optimized data searching using index files. The main goal of the Funtools project has been to develop a minimal buy-in FITS library for researchers who are occasional (but serious) coders. In this case, "minimal buy-in" means "easy to learn, easy to use, and easy to re-learn next month". We have tried to achieve this goal by emphasizing two essential capabilities. The first is the ability to develop FITS programs without knowing much about FITS, i.e., without having to deal with the arcane rules for generating a properly formatted FITS file. The second is to support the use of already- familiar C/Unix facilities, especially C structs and Unix stdio. Taken together, these two capabilities should allow researchers to lever- age their existing programming expertise while minimizing the need to learn new and complex coding rules. Choose from the following topics: o Funtools User Programs o funcalc: Funtools calculator (for binary tables) [funcalc(1)] o funcen: find centroid (for binary tables) [funcen(1)] o funcnts: count photons in specified regions [funcnts(1)] o funcone: cone search on RA, Dec columns [funcone(1)] o fundisp: display data in a Funtools data file [fundisp(1)] o funhead: display a header in a Funtools file [funhead(1)] o funhist: create a 1D histogram of a column [funhist(1)] o funimage: create a FITS image from a Funtools data file [funimage(1)] o funindex: create an index on a column in a binary table [funindex(1)] o funjoin: join two or more FITS binary tables on specified columns [funjoin(1)] o funmerge: merge one or more Funtools table files [funmerge(1)] o funsky: convert between image and sky coordinates, using WCS info from a FITS header [funsky(1)] o funtable: copy selected rows from a Funtools file to a FITS binary table [funtable(1)] o funtbl: extract a table from Funtools ASCII output [funtbl(1)] o funtools and ds9 image display [funds9(7)] o Funtools Programming o Funtools Programming Summary [funlib(3)] o Funtools Programming Tutorial [funlib(3)] o A Short Digression on Subroutine Order [funlib(3)] o Compiling and Linking [funlib(3)] o The Funtools Reference Handle [funlib(3)] o The Funtools Programming Reference Manual o FunOpen: open a Funtools file [funopen(3)] o FunImageGet: retrieve image data [funimageget(3)] o FunImagePut: output image data [funimageput(3)] o FunImageRowGet: retrieve image data by row [funimagerowget(3)] o FunImageRowPut: output image data by row [funimagerowput(3)] o FunTableRowGet: retrieve rows from a table [funtablerowget(3)] o FunTableRowPut: output rows to a table [funtablerowput(3)] o FunColumnSelect: select columns in a table for access [funcolumnselect(3)] o FunColumnActivate: activate columns in a table for read/write [funcolumnactivate(3)] o FunColumnLookup: lookup info about the columns in a table [funcolumnlookup(3)] o FunInfoGet: get info about an image or table [funinfoget(3)] o FunInfoPut: put info about an image or table [funinfoput(3)] o FunParamGet: get header param [funparamget(3)] o FunParamPut: put header param [funparamput(3)] o FunFlush: flush I/O in a Funtools file [funflush(3)] o FunClose: close a Funtools file [funclose(3)] o Funtools Programming Examples [funlib(3)] o evmerge: merge new columns with existing columns o evcols: add column and rows to binary tables o imblank: blank out image values below a threshold o Funtools Data Files [funfiles(7)] o Supported Data Formats o FITS File and Extensions o Non-FITS Raw Event Files o Non-FITS Array Files o Column-based Text (ASCII) Files o Database Views of Tables o Image Sections and Blocking o Binning FITS Binary Tables and Non-FITS Event Files o Disk Files and Other Supported File Types o Funtools Data Filtering o Table Filtering [funfilters(7)] o Fast Table Filtering using Indexes [funidx(7)] o Spatial Region Filtering [funregions(7)] o Region Geometry [reggeometry(7)] o Region Algebra [regalgebra(7)] o Region Coordinates [regcoords(7)] o Region Boundaries [regbounds(7)] o Differences Between Funtools and IRAF Regions [regdiff(7)] o Combining Table and Region Filters [funcombine(7)] o Miscellaneous o Funtools Environment Variables [funenv(7)] o Funtools ChangeLog version 1.4.2 January 2, 2008 funtools(7)