GNU Astronomy Utilities

Previous: , Up: MakeProfiles   [Contents][Index]

8.1.5 Invoking MakeProfiles

MakeProfiles will make any number of profiles specified in a catalog either individually or in one image. The executable name is astmkprof with the following general template

$ astmkprof [OPTION ...] [Catalog]

One line examples:

## Make an image with profiles in catalog.txt (with default size):
$ astmkprof catalog.txt

## Make the profiles in catalog.txt over image.fits:
$ astmkprof --background=image.fits catalog.txt

## Make a Moffat PSF with FWHM 3pix, beta=2.8, truncation=5
$ astmkprof --kernel=moffat,2.8,5 --oversample=1

## Make profiles in catalog, using RA and Dec in the given column:
$ astmkprof --ccol=RA_CENTER --ccol=DEC_CENTER --mode=wcs catalog.txt

## Make a 1500x1500 merged image (oversampled 500x500) image along
## with an individual image for all the profiles in catalog:
$ astmkprof --individual --oversample 3 --mergedsize=500,500 cat.txt

The parameters of the mock profiles can either be given through a catalog (which stores the parameters of many mock profiles, see MakeProfiles catalog), or the --kernel option (see MakeProfiles output dataset). The catalog can be in the FITS ASCII, FITS binary format, or plain text formats (see Tables). A plain text catalog can also be provided using the Standard input (see Standard input). The columns related to each parameter can be determined both by number, or by match/search criteria using the column names, units, or comments. with the options ending in col, see below.

Without any file given to the --background option, MakeProfiles will make a zero-valued image and build the profiles on that (its size and main WCS parameters can also be defined through the options described in MakeProfiles output dataset). Besides the main/merged image containing all the profiles in the catalog, it is also possible to build individual images for each profile (only enclosing one full profile to its truncation radius) with the --individual option.

If an image is given to the --background option, the pixels of that image are used as the background value for every pixel. The flux value of each profile pixel will be added to the pixel in that background value. In this case, the values to all options relating to the output size and WCS will be ignored if specified (for example --oversample, --mergedsize, and --prepforconv) on the command-line or in the configuration files.

The sections below discuss the options specific to MakeProfiles based on context: the input catalog settings which can have many rows for different profiles are discussed in MakeProfiles catalog, in MakeProfiles profile settings, we discuss how you can set general profile settings (that are the same for all the profiles in the catalog). Finally MakeProfiles output dataset and MakeProfiles log file discuss the outputs of MakeProfiles and how you can configure them. Besides these, MakeProfiles also supports all the common Gnuastro program options that are discussed in Common options, so please flip through them is well for a more comfortable usage.

Please see Sufi simulates a detection for a very complete tutorial explaining how one could use MakeProfiles in conjunction with other Gnuastro’s programs to make a complete simulated image of a mock galaxy.

Previous: , Up: MakeProfiles   [Contents][Index]