]> git.pld-linux.org Git - packages/gnuastro.git/blame - gnuastro-info.patch
libgit2 1.7.x rebuild
[packages/gnuastro.git] / gnuastro-info.patch
CommitLineData
fa459b9f
JB
1--- gnuastro-0.19/doc/gnuastro.texi.orig 2022-10-24 02:00:42.000000000 +0200
2+++ gnuastro-0.19/doc/gnuastro.texi 2023-01-19 21:52:35.888478772 +0100
f89484e7 3@@ -50,74 +50,74 @@ A copy of the license is included in the
c34b9402
JB
4 @c To include in the info directory.
5 @dircategory Astronomy
6 @direntry
7-* Gnuastro: (gnuastro). GNU Astronomy Utilities.
8-* libgnuastro: (gnuastro)Gnuastro library. Full Gnuastro library doc.
f89484e7 9+* Gnuastro: (gnuastro). GNU Astronomy Utilities
91d86768 10+* libgnuastro: (gnuastro)Gnuastro library. Full Gnuastro library doc
c34b9402 11
0766af6e 12-* help-gnuastro: (gnuastro)help-gnuastro mailing list. Getting help.
91d86768 13+* help-gnuastro: (gnuastro)help-gnuastro mailing list. Getting help
c34b9402
JB
14
15-* bug-gnuastro: (gnuastro)Report a bug. How to report bugs
f89484e7 16+* bug-gnuastro: (gnuastro)Report a bug. How to report bugs
c34b9402
JB
17
18-* Arithmetic: (gnuastro)Arithmetic. Arithmetic operations on pixels.
19-* astarithmetic: (gnuastro)Invoking astarithmetic. Options to Arithmetic.
f89484e7 20+* Arithmetic: (gnuastro)Arithmetic. Arithmetic operations on pixels
91d86768 21+* astarithmetic: (gnuastro)astarithmetic. Options to Arithmetic
c34b9402
JB
22
23-* BuildProgram: (gnuastro)BuildProgram. Compile and run programs using Gnuastro's library.
24-* astbuildprog: (gnuastro)Invoking astbuildprog. Options to BuildProgram.
f89484e7
JB
25+* BuildProgram: (gnuastro)BuildProgram. Compile and run programs using Gnuastro's library
26+* astbuildprog: (gnuastro)astbuildprog. Options to BuildProgram
c34b9402
JB
27
28-* ConvertType: (gnuastro)ConvertType. Convert different file types.
29-* astconvertt: (gnuastro)Invoking astconvertt. Options to ConvertType.
f89484e7
JB
30+* ConvertType: (gnuastro)ConvertType. Convert different file types
31+* astconvertt: (gnuastro)astconvertt. Options to ConvertType
c34b9402
JB
32
33-* Convolve: (gnuastro)Convolve. Convolve an input file with kernel.
34-* astconvolve: (gnuastro)Invoking astconvolve. Options to Convolve.
f89484e7
JB
35+* Convolve: (gnuastro)Convolve. Convolve an input file with kernel
36+* astconvolve: (gnuastro)astconvolve. Options to Convolve
c34b9402
JB
37
38-* CosmicCalculator: (gnuastro)CosmicCalculator. For cosmological params.
39-* astcosmiccal: (gnuastro)Invoking astcosmiccal. Options to CosmicCalculator.
91d86768 40+* CosmicCalculator: (gnuastro)CosmicCalculator. For cosmological params
f89484e7 41+* astcosmiccal: (gnuastro)astcosmiccal. Options to CosmicCalculator
c34b9402
JB
42
43-* Crop: (gnuastro)Crop. Crop region(s) from image(s).
44-* astcrop: (gnuastro)Invoking astcrop. Options to Crop.
f89484e7
JB
45+* Crop: (gnuastro)Crop. Crop region(s) from image(s)
46+* astcrop: (gnuastro)astcrop. Options to Crop
c34b9402
JB
47
48-* Fits: (gnuastro)Fits. View and manipulate FITS extensions and keywords.
49-* astfits: (gnuastro)Invoking astfits. Options to Fits.
f89484e7
JB
50+* Fits: (gnuastro)Fits. View and manipulate FITS extensions and keywords
51+* astfits: (gnuastro)astfits. Options to Fits
c34b9402
JB
52
53-* MakeCatalog: (gnuastro)MakeCatalog. Make a catalog from labeled image.
54-* astmkcatalog: (gnuastro)Invoking astmkcatalog. Options to MakeCatalog.
f89484e7
JB
55+* MakeCatalog: (gnuastro)MakeCatalog. Make a catalog from labeled image
56+* astmkcatalog: (gnuastro)astmkcatalog. Options to MakeCatalog
c34b9402
JB
57
58-* MakeNoise: (gnuastro)MakeNoise. Make (add) noise to an image.
59-* astmknoise: (gnuastro)Invoking astmknoise. Options to MakeNoise.
f89484e7
JB
60+* MakeNoise: (gnuastro)MakeNoise. Make (add) noise to an image
61+* astmknoise: (gnuastro)astmknoise. Options to MakeNoise
c34b9402
JB
62
63-* MakeProfiles: (gnuastro)MakeProfiles. Make mock profiles.
64-* astmkprof: (gnuastro)Invoking astmkprof. Options to MakeProfiles.
f89484e7
JB
65+* MakeProfiles: (gnuastro)MakeProfiles. Make mock profiles
66+* astmkprof: (gnuastro)astmkprof. Options to MakeProfiles
635d3ed9
JB
67
68-* Match: (gnuastro)Match. Match two separate catalogs.
69-* astmatch: (gnuastro)Invoking astmatch. Options to Match.
f89484e7
JB
70+* Match: (gnuastro)Match. Match two separate catalogs
71+* astmatch: (gnuastro)astmatch. Options to Match
c34b9402
JB
72
73-* NoiseChisel: (gnuastro)NoiseChisel. Detect signal in noise.
74-* astnoisechisel: (gnuastro)Invoking astnoisechisel. Options to NoiseChisel.
f89484e7 75+* NoiseChisel: (gnuastro)NoiseChisel. Detect signal in noise
91d86768 76+* astnoisechisel: (gnuastro)astnoisechisel. Options to NoiseChisel
635d3ed9
JB
77
78-* Segment: (gnuastro)Segment. Segment detections based on signal structure.
79-* astsegment: (gnuastro)Invoking astsegment. Options to Segment.
f89484e7
JB
80+* Segment: (gnuastro)Segment. Segment detections based on signal structure
81+* astsegment: (gnuastro)astsegment. Options to Segment
c34b9402 82
0766af6e
JB
83-* Query: (gnuastro)Query. Access remote databases for downloading data.
84-* astquery: (gnuastro)Invoking astquery. Options to Query.
f89484e7
JB
85+* Query: (gnuastro)Query. Access remote databases for downloading data
86+* astquery: (gnuastro)astquery. Options to Query
0766af6e 87
c34b9402
JB
88-* Statistics: (gnuastro)Statistics. Get image Statistics.
89-* aststatistics: (gnuastro)Invoking aststatistics. Options to Statistics.
f89484e7 90+* Statistics: (gnuastro)Statistics. Get image Statistics
91d86768 91+* aststatistics: (gnuastro)aststatistics. Options to Statistics
c34b9402
JB
92
93-* Table: (gnuastro)Table. Read and write FITS binary or ASCII tables.
94-* asttable: (gnuastro)Invoking asttable. Options to Table.
f89484e7
JB
95+* Table: (gnuastro)Table. Read and write FITS binary or ASCII tables
96+* asttable: (gnuastro)asttable. Options to Table
c34b9402
JB
97
98-* Warp: (gnuastro)Warp. Warp a dataset to a new grid.
99-* astwarp: (gnuastro)Invoking astwarp. Options to Warp.
f89484e7
JB
100+* Warp: (gnuastro)Warp. Warp a dataset to a new grid
101+* astwarp: (gnuastro)astwarp. Options to Warp
c34b9402 102
91d86768 103-* astscript: (gnuastro)Installed scripts. Gnuastro's installed scripts.
fdaea0fb 104-* astscript-sort-by-night: (gnuastro)Invoking astscript-sort-by-night. Options to this script
91d86768 105-* astscript-radial-profile: (gnuastro)Invoking astscript-radial-profile. Options to this script
0766af6e 106-* astscript-ds9-region: (gnuastro)Invoking astscript-ds9-region. Options to this script
f89484e7
JB
107-* astscript-fits-view: (gnuastro)Invoking astscript-fits-view. Options to this script
108-* astscript-psf-select-stars: (gnuastro)Invoking astscript-psf-select-stars. Options to this script
109-* astscript-psf-stamp: (gnuastro)Invoking astscript-psf-stamp. Options to this script
110-* astscript-psf-unite: (gnuastro)Invoking astscript-psf-unite. Options to this script
111-* astscript-psf-scale-factor: (gnuastro)Invoking astscript-psf-scale-factor. Options to this script
112-* astscript-psf-subtract: (gnuastro)Invoking astscript-psf-subtract. Options to this script
113+* astscript: (gnuastro)Installed scripts. Gnuastro's installed scripts
114+* astscript-sort-by-night: (gnuastro)astscript-sort-by-night. Options to this script
115+* astscript-radial-profile: (gnuastro)astscript-radial-profile. Options to this script
116+* astscript-ds9-region: (gnuastro)astscript-ds9-region. Options to this script
117+* astscript-fits-view: (gnuastro)astscript-fits-view. Options to this script
118+* astscript-psf-select-stars: (gnuastro)astscript-psf-select-stars. Options to this script
119+* astscript-psf-stamp: (gnuastro)astscript-psf-stamp. Options to this script
120+* astscript-psf-unite: (gnuastro)astscript-psf-unite. Options to this script
121+* astscript-psf-scale-factor: (gnuastro)astscript-psf-scale-factor. Options to this script
122+* astscript-psf-subtract: (gnuastro)astscript-psf-subtract. Options to this script
c34b9402
JB
123 @end direntry
124
f89484e7 125
fa459b9f 126@@ -433,7 +433,7 @@ Data containers
c34b9402
JB
127
128 Fits
129
130-* Invoking astfits:: Arguments and options to Header.
131+* astfits:: Arguments and options to Header.
132
133 Invoking Fits
134
fa459b9f 135@@ -448,7 +448,7 @@ ConvertType
c34b9402 136 * Color:: Some explanations on color.
fa459b9f 137 * Color channels in same pixel grid:: When the WCS slightly differs.
91d86768 138 * Annotations for figure in paper:: Adding coordinates or physical scale.
c34b9402
JB
139-* Invoking astconvertt:: Options and arguments to ConvertType.
140+* astconvertt:: Options and arguments to ConvertType.
141
fa459b9f 142 Color
91d86768 143
fa459b9f 144@@ -470,12 +470,12 @@ Table
c34b9402 145
fdaea0fb 146 * Column arithmetic:: How to do operations on table columns.
91d86768 147 * Operation precedence in Table:: Order of running options in Table.
c34b9402
JB
148-* Invoking asttable:: Options and arguments to Table.
149+* asttable:: Options and arguments to Table.
150
0766af6e
JB
151 Query
152
153 * Available databases:: List of available databases to Query.
154-* Invoking astquery:: Inputs, outputs and configuration of Query.
155+* astquery:: Inputs, outputs and configuration of Query.
156
c34b9402
JB
157 Data manipulation
158
fa459b9f 159@@ -489,7 +489,7 @@ Crop
c34b9402
JB
160 * Crop modes:: Basic modes to define crop region.
161 * Crop section syntax:: How to define a section to crop.
162 * Blank pixels:: Pixels with no value.
163-* Invoking astcrop:: Calling Crop on the command-line
164+* astcrop:: Calling Crop on the command-line
165
166 Invoking Crop
167
fa459b9f 168@@ -502,7 +502,7 @@ Arithmetic
c34b9402 169 * Reverse polish notation:: The current notation style for Arithmetic
f89484e7 170 * Integer benefits and pitfalls:: Integers have major benefits, but require care
c34b9402
JB
171 * Arithmetic operators:: List of operators known to Arithmetic
172-* Invoking astarithmetic:: How to run Arithmetic: options and output
173+* astarithmetic:: How to run Arithmetic: options and output
174
91d86768 175 Arithmetic operators
c34b9402 176
fa459b9f 177@@ -531,7 +531,7 @@ Convolve
c34b9402
JB
178 * Frequency domain and Fourier operations:: Using frequencies in input.
179 * Spatial vs. Frequency domain:: When to use which?
180 * Convolution kernel:: How to specify the convolution kernel.
181-* Invoking astconvolve:: Options and argument to Convolve.
182+* astconvolve:: Options and argument to Convolve.
183
184 Spatial domain convolution
185
fa459b9f 186@@ -557,7 +557,7 @@ Warp
c34b9402
JB
187 * Merging multiple warpings:: How to merge multiple matrices.
188 * Resampling:: Warping an image is re-sampling it.
fa459b9f 189 * Moire pattern and its correction:: Spatial resonance of the grid pattern on output.
c34b9402
JB
190-* Invoking astwarp:: Arguments and options for Warp.
191+* astwarp:: Arguments and options for Warp.
192
fa459b9f 193 Invoking Warp
c34b9402 194
fa459b9f 195@@ -579,7 +579,7 @@ Statistics
c34b9402 196 * Sigma clipping:: Definition of @mymath{\sigma}-clipping.
fa459b9f 197 * Least squares fitting:: Fitting with various parametric functions.
c34b9402
JB
198 * Sky value:: Definition and derivation of the Sky value.
199-* Invoking aststatistics:: Arguments and options to Statistics.
200+* aststatistics:: Arguments and options to Statistics.
201
0766af6e 202 2D Histograms
1d5db55b 203
fa459b9f 204@@ -604,7 +604,7 @@ Invoking Statistics
c34b9402
JB
205 NoiseChisel
206
0766af6e 207 * NoiseChisel changes after publication:: Updates since published papers.
c34b9402
JB
208-* Invoking astnoisechisel:: Options and arguments for NoiseChisel.
209+* astnoisechisel:: Options and arguments for NoiseChisel.
210
211 Invoking NoiseChisel
212
fa459b9f 213@@ -614,7 +614,7 @@ Invoking NoiseChisel
1d5db55b 214
635d3ed9
JB
215 Segment
216
635d3ed9
JB
217-* Invoking astsegment:: Inputs, outputs and options to Segment
218+* astsegment:: Inputs, outputs and options to Segment
219
220 Invoking Segment
221
fa459b9f 222@@ -629,7 +629,7 @@ MakeCatalog
c34b9402
JB
223 * Quantifying measurement limits:: For comparing different catalogs.
224 * Measuring elliptical parameters:: Estimating elliptical parameters.
225 * Adding new columns to MakeCatalog:: How to add new columns.
226-* Invoking astmkcatalog:: Options and arguments to MakeCatalog.
227+* astmkcatalog:: Options and arguments to MakeCatalog.
228
0766af6e 229 Quantifying measurement limits
c34b9402 230
fa459b9f 231@@ -651,7 +651,7 @@ Invoking MakeCatalog
c34b9402
JB
232 Match
233
f89484e7 234 * Matching algorithms:: Different ways to find the match
c34b9402
JB
235-* Invoking astmatch:: Inputs, outputs and options of Match
236+* astmatch:: Inputs, outputs and options of Match
237
fa459b9f 238 Data modeling
c34b9402 239
fa459b9f 240@@ -663,7 +663,7 @@ MakeProfiles
0766af6e 241 * Modeling basics:: Astronomical modeling basics.
c34b9402 242 * If convolving afterwards:: Considerations for convolving later.
c34b9402
JB
243 * Profile magnitude:: Definition of total profile magnitude.
244-* Invoking astmkprof:: Inputs and Options for MakeProfiles.
245+* astmkprof:: Inputs and Options for MakeProfiles.
246
247 Modeling basics
248
fa459b9f 249@@ -684,7 +684,7 @@ Invoking MakeProfiles
c34b9402
JB
250 MakeNoise
251
252 * Noise basics:: Noise concepts and definitions.
253-* Invoking astmknoise:: Options and arguments to MakeNoise.
254+* astmknoise:: Options and arguments to MakeNoise.
255
256 Noise basics
257
fa459b9f 258@@ -701,7 +701,7 @@ CosmicCalculator
c34b9402
JB
259
260 * Distance on a 2D curved space:: Distances in 2D for simplicity
261 * Extending distance concepts to 3D:: Going to 3D (our real universe).
262-* Invoking astcosmiccal:: How to run CosmicCalculator
263+* astcosmiccal:: How to run CosmicCalculator
264
265 Invoking CosmicCalculator
266
fa459b9f 267@@ -719,28 +719,28 @@ Installed scripts
0766af6e
JB
268
269 Sort FITS files by night
270
271-* Invoking astscript-sort-by-night:: Inputs and outputs to this script.
fa459b9f 272+* astscript-sort-by-night:: Inputs and outputs to this script.
0766af6e
JB
273
274 Generate radial profile
275
276-* Invoking astscript-radial-profile:: How to call astscript-radial-profile
fa459b9f 277+* astscript-radial-profile:: How to call astscript-radial-profile
0766af6e
JB
278
279 SAO DS9 region files from table
280
281-* Invoking astscript-ds9-region:: How to call astscript-ds9-region
fa459b9f 282+* astscript-ds9-region:: How to call astscript-ds9-region
f89484e7
JB
283
284 Viewing FITS file contents with DS9 or TOPCAT
285
286-* Invoking astscript-fits-view:: How to call this script
fa459b9f 287+* astscript-fits-view:: How to call this script
f89484e7
JB
288
289 PSF construction and subtraction
290
291 * Overview of the PSF scripts:: Summary of concepts and methods
292-* Invoking astscript-psf-select-stars:: Select good starts within an image.
293-* Invoking astscript-psf-stamp:: Make a stamp of each star to stack.
294-* Invoking astscript-psf-unite:: Merge stacks of different regions of PSF.
295-* Invoking astscript-psf-scale-factor:: Calculate factor to scale PSF to star.
296-* Invoking astscript-psf-subtract:: Put the PSF in the image to subtract.
fa459b9f
JB
297+* astscript-psf-select-stars:: Select good starts within an image.
298+* astscript-psf-stamp:: Make a stamp of each star to stack.
299+* astscript-psf-unite:: Merge stacks of different regions of PSF.
300+* astscript-psf-scale-factor:: Calculate factor to scale PSF to star.
301+* astscript-psf-subtract:: Put the PSF in the image to subtract.
0766af6e 302
fa459b9f 303 Makefile extensions (for GNU Make)
0766af6e 304
fa459b9f 305@@ -762,7 +762,7 @@ Review of library fundamentals
c34b9402
JB
306
307 BuildProgram
308
309-* Invoking astbuildprog:: Options and examples for using this program.
310+* astbuildprog:: Options and examples for using this program.
311
312 Gnuastro library
313
fa459b9f
JB
314@@ -988,7 +988,7 @@ $ sudo make install
315 @c The last command is to enable Gnuastro's custom TAB completion in Bash.
316 @c For more on this useful feature, see @ref{Shell TAB completion}).
1d5db55b 317
fa459b9f
JB
318-For each program there is an `Invoke ProgramName' sub-section in this book which explains how the programs should be run on the command-line (for example, see @ref{Invoking asttable}).
319+For each program there is an `Invoking ProgramName' sub-section in this book which explains how the programs should be run on the command-line (for example, see @ref{asttable}).
0766af6e 320
fa459b9f 321 In @ref{Tutorials}, we have prepared some complete tutorials with common Gnuastro usage scenarios in astronomical research.
0766af6e 322 They even contain links to download the necessary data, and thoroughly describe every step of the process (the science, statistics and optimal usage of the command-line).
fa459b9f 323@@ -1812,7 +1812,7 @@ But they need to be as realistic as poss
1d5db55b
JB
324 In these tutorials, we have intentionally avoided too many cross references to make it more easy to read.
325 For more information about a particular program, you can visit the section with the same name as the program in this book.
fa459b9f
JB
326 Each program section in the subsequent chapters starts by explaining the general concepts behind what it does, for example, see @ref{Convolve}.
327-If you only want practical information on running a program, for example, its options/configuration, input(s) and output(s), please consult the subsection titled ``Invoking ProgramName'', for example, see @ref{Invoking astnoisechisel}.
328+If you only want practical information on running a program, for example, its options/configuration, input(s) and output(s), please consult the subsection titled ``Invoking ProgramName'', for example, see @ref{astnoisechisel}.
1d5db55b 329 For an explanation of the conventions we use in the example codes through the book, please see @ref{Conventions}.
635d3ed9
JB
330
331 @menu
fa459b9f
JB
332@@ -1927,7 +1927,7 @@ To return to the previous page, press @k
333 If you are searching for a specific phrase in the whole book (for example, an option name), press @key{s} and type your search phrase and end it with an @key{<ENTER>}.
1d5db55b 334
fa459b9f 335 You do not need to start from the top of the manual every time.
1d5db55b 336-For example, to get to @ref{Invoking astnoisechisel}, run the following command.
1d5db55b 337+For example, to get to @ref{astnoisechisel}, run the following command.
fa459b9f 338 In general, all programs have such an ``Invoking ProgramName'' section in this book.
1d5db55b
JB
339 These sections are specifically for the description of inputs, outputs and configuration options of each program.
340 You can access them directly for each program by giving its executable name to Info.
fa459b9f
JB
341@@ -2036,7 +2036,7 @@ $ astscript-fits-view \
342 After running this command, you will see that the DS9 window fully covers the height of your monitor, it is showing the whole image, using a more clear color-map, and many more useful things.
343 In fact, you see the DS9 command that is used in your terminal@footnote{When comparing DS9's command-line options to Gnuastro's, you will notice how SAO DS9 does not follow the GNU style of options where ``long'' and ``short'' options are preceded by @option{--} and @option{-} respectively (for example, @option{--width} and @option{-w}, see @ref{Options}).}.
344 On GNU/Linux operating systems (like Ubuntu, and Fedora), you can also set your graphics user interface to use this script for opening FITS files when you click on them.
345-For more, see the instructions in the checklist at the start of @ref{Invoking astscript-fits-view}.
346+For more, see the instructions in the checklist at the start of @ref{astscript-fits-view}.
347
348 As you hover your mouse over the image, notice how the ``Value'' and positional fields on the top of the ds9 window get updated.
349 The first thing you might notice is that when you hover the mouse over the regions with no data, they have a value of zero.
350@@ -2667,7 +2667,7 @@ As you see in the matrix that is printed
1d5db55b
JB
351 However, if you run Warp multiple times, the pixels will be mixed multiple times, creating a strong artificial blur/smoothing, or stronger correlated noise.
352
353 Recall that the merging of multiple warps is done through matrix multiplication, therefore order matters in the separate operations.
fa459b9f
JB
354-At a lower level, through Warp's @option{--matrix} option, you can directly request your desired final warp and do not have to break it up into different warps like above (see @ref{Invoking astwarp}).
355+At a lower level, through Warp's @option{--matrix} option, you can directly request your desired final warp and do not have to break it up into different warps like above (see @ref{astwarp}).
1d5db55b 356
fa459b9f 357 Fortunately these datasets are already aligned to the same pixel grid, so you do not actually need the files that were just generated.You can safely delete them all with the following command.
1d5db55b 358 Here, you see why we put the processed outputs that we need later into a separate directory.
fa459b9f 359@@ -3864,7 +3864,7 @@ $ cat apertures.txt
1d5db55b
JB
360 We can now feed this catalog into MakeProfiles using the command below to build the apertures over the image.
361 The most important option for this particular job is @option{--mforflatpix}, it tells MakeProfiles that the values in the magnitude column should be used for each pixel of a flat profile.
362 Without it, MakeProfiles would build the profiles such that the @emph{sum} of the pixels of each profile would have a @emph{magnitude} (in log-scale) of the value given in that column (what you would expect when simulating a galaxy for example).
363-See @ref{Invoking astmkprof} for details on the options.
364+See @ref{astmkprof} for details on the options.
365
366 @example
0766af6e 367 $ astmkprof apertures.txt --background=flat-ir/xdf-f160w.fits \
fa459b9f 368@@ -6673,7 +6673,7 @@ $ echo $scale
f89484e7
JB
369 @end example
370
371 Now that we know the scaling factor, we are ready to unite the outer and the inner part of the PSF.
372-To do that, we will use the script @file{astscript-psf-unite} with the command below (for more on this script, see @ref{Invoking astscript-psf-unite}).
373+To do that, we will use the script @file{astscript-psf-unite} with the command below (for more on this script, see @ref{astscript-psf-unite}).
374 The basic parameters are the inner part of the PSF (given to @option{--inner}), the inner part's scale factor (@option{--scale}), and the junction radius (@option{--radius}).
375 The inner part is first scaled, and all the pixels of the outer image within the given radius are replaced with the pixels of the inner image.
376 Since the flux factor was computed for a ring of pixels between 10 and 15 pixels, let's set the junction radius to be 12 pixels (roughly in between 10 and 15):
fa459b9f 377@@ -9567,7 +9567,7 @@ Afterwards, in @ref{Common options}, we
1d5db55b
JB
378 @cindex Arguments to programs
379 @cindex Command-line arguments
380 When you type a command on the command-line, it is passed onto the shell (a generic name for the program that manages the command-line) as a string of characters.
381-As an example, see the ``Invoking ProgramName'' sections in this manual for some examples of commands with each program, like @ref{Invoking asttable}, @ref{Invoking astfits}, or @ref{Invoking aststatistics}.
fa459b9f 382+As an example, see the ``Invoking ProgramName'' sections in this manual for some examples of commands with each program, like @ref{asttable}, @ref{astfits}, or @ref{aststatistics}.
1d5db55b
JB
383
384 The shell then brakes up your string into separate @emph{tokens} or @emph{words} using any @emph{metacharacters} (like white-space, tab, @command{|}, @command{>} or @command{;}) that are in the string.
385 On the command-line, the first thing you usually enter is the name of the program you want to run.
fa459b9f 386@@ -9679,7 +9679,7 @@ Command-line options allow configuring t
1d5db55b 387 A single option can be called in two ways: @emph{long} or @emph{short}.
fa459b9f
JB
388 All options in Gnuastro accept the long format which has two hyphens an can have many characters (for example, @option{--hdu}).
389 Short options only have one hyphen (@key{-}) followed by one character (for example, @option{-h}).
1d5db55b
JB
390-You can see some examples in the list of options in @ref{Common options} or those for each program's ``Invoking ProgramName'' section.
391+You can see some examples in the list of options in @ref{Common options} or those for each program's ``ProgramName'' section.
392 Both formats are shown for those which support both.
393 First the short is shown then the long.
394
fa459b9f
JB
395@@ -9753,7 +9753,7 @@ If you are satisfied with the change, yo
396 If the change was not satisfactory, you can remove the one you just added and not worry about forgetting the original value.
1d5db55b
JB
397 Without this capability, you would have to memorize or save the original value somewhere else, run the command and then change the value again which is not at all convenient and is potentially cause lots of bugs.
398
fa459b9f
JB
399-On the other hand, some options can be called multiple times in one run of a program and can thus take multiple values (for example, see the @option{--column} option in @ref{Invoking asttable}.
400+On the other hand, some options can be called multiple times in one run of a program and can thus take multiple values (for example, see the @option{--column} option in @ref{asttable}.
1d5db55b
JB
401 In these cases, the order of stored values is the same order that you specified on the command-line.
402
403 @cindex Configuration files
fa459b9f 404@@ -10224,7 +10224,7 @@ As another example, if an option needs i
0766af6e
JB
405 Just note that the file name has to be already given on the command-line before reaching such options (that look into the contents of a file).
406
407 But TAB completion is not limited to file types or contents.
fa459b9f
JB
408-Arguments/Options that take certain fixed string values will directly suggest those strings with TAB, and completely ignore the file structure (for example, spectral line names in @ref{Invoking astcosmiccal})!
409+Arguments/Options that take certain fixed string values will directly suggest those strings with TAB, and completely ignore the file structure (for example, spectral line names in @ref{astcosmiccal})!
0766af6e
JB
410 As another example, the option @option{--numthreads} option (to specify the number of threads to use by the program), will find the number of available threads on the system, and suggest the possible numbers with a TAB!
411
fa459b9f
JB
412 To activate Gnuastro's custom TAB completion in Bash, you need to put the following line in one of your Bash startup files (for example, @file{~/.bashrc}).
413@@ -10344,7 +10344,7 @@ All the values must either be stored in
1d5db55b
JB
414 In case the necessary parameters are not given through any of these methods, the program will print a missing option error and abort.
415 The only exception to this is @option{--numthreads}, whose default value is determined at run-time using the number of threads available to your system, see @ref{Multi-threaded operations}.
fa459b9f
JB
416 Of course, you can still provide a default value for the number of threads at any of the levels below, but if you do not, the program will not abort.
417-Also note that through automatic output name generation, the value to the @option{--output} option is also not mandatory on the command-line or in the configuration files for all programs which do not rely on that value as an input@footnote{One example of a program which uses the value given to @option{--output} as an input is ConvertType, this value specifies the type of the output through the value to @option{--output}, see @ref{Invoking astconvertt}.}, see @ref{Automatic output}.
418+Also note that through automatic output name generation, the value to the @option{--output} option is also not mandatory on the command-line or in the configuration files for all programs which do not rely on that value as an input@footnote{One example of a program which uses the value given to @option{--output} as an input is ConvertType, this value specifies the type of the output through the value to @option{--output}, see @ref{astconvertt}.}, see @ref{Automatic output}.
1d5db55b
JB
419
420
fdaea0fb 421
fa459b9f 422@@ -11153,7 +11153,7 @@ Each column in the table contains the va
1d5db55b
JB
423 For example, let's assume you have just ran MakeCatalog (see @ref{MakeCatalog}) on an image to measure some properties for the labeled regions (which might be detected galaxies for example) in the image.
424 For each labeled region (detected galaxy), there will be a @emph{row} which groups its measured properties as @emph{columns}, one column for each property.
425 One such property can be the object's magnitude, which is the sum of pixels with that label, or its center can be defined as the light-weighted average value of those pixels.
426-Many such properties can be derived from the raw pixel values and their position, see @ref{Invoking astmkcatalog} for a long list.
427+Many such properties can be derived from the raw pixel values and their position, see @ref{astmkcatalog} for a long list.
428
429 As a summary, for each labeled region (or, galaxy) we have one @emph{row} and for each measured property we have one @emph{column}.
fa459b9f
JB
430 This high-level structure is usually the first step for higher-level analysis, for example, finding the stellar mass or photometric redshift from magnitudes in multiple colors.
431@@ -11775,10 +11775,10 @@ for example, you can copy or cut (copy a
1d5db55b 432 It also has features to delete, add, or edit meta-data keywords within one HDU.
c34b9402
JB
433
434 @menu
435-* Invoking astfits:: Arguments and options to Header.
436+* astfits:: Arguments and options to Header.
437 @end menu
438
439-@node Invoking astfits, , Fits, Fits
440+@node astfits, , Fits, Fits
441 @subsection Invoking Fits
442
1d5db55b 443 Fits can print or manipulate the FITS file HDUs (extensions), meta-data keywords in a given HDU.
fa459b9f 444@@ -11874,7 +11874,7 @@ These three classes of options cannot be
c34b9402
JB
445
446
447
0766af6e
JB
448-@node HDU information and manipulation, Keyword inspection and manipulation, Invoking astfits, Invoking astfits
449+@node HDU information and manipulation, Keyword inspection and manipulation, astfits, astfits
450 @subsubsection HDU information and manipulation
451 Each FITS file header data unit, or HDU (also known as an extension) is an independent dataset (data + meta-data).
1d5db55b 452 Multiple HDUs can be stored in one FITS file, see @ref{Fits}.
fa459b9f
JB
453@@ -11892,7 +11892,7 @@ Note that this option must be called alo
454 It is thus useful in scripts, for example, when you need to do check the number of extensions in a FITS file.
2ed15334 455
fa459b9f 456 For a complete list of basic meta-data on the extensions in a FITS file, do not use any of the options in this section or in @ref{Keyword inspection and manipulation}.
1d5db55b
JB
457-For more, see @ref{Invoking astfits}.
458+For more, see @ref{astfits}.
2ed15334 459
0766af6e
JB
460 @item --hastablehdu
461 Print @code{1} (on standard output) if at least one table HDU (ASCII or binary) exists in the FITS file.
fa459b9f 462@@ -12038,7 +12038,7 @@ If we had not used @option{--primaryimgh
c34b9402
JB
463 @end table
464
465
fa459b9f
JB
466-@node Keyword inspection and manipulation, Pixel information images, HDU information and manipulation, Invoking astfits
467+@node Keyword inspection and manipulation, Pixel information images, HDU information and manipulation, astfits
0766af6e 468 @subsubsection Keyword inspection and manipulation
1d5db55b
JB
469 The meta-data in each header data unit, or HDU (also known as extension, see @ref{Fits}) is stored as ``keyword''s.
470 Each keyword consists of a name, value, unit, and comments.
fa459b9f 471@@ -12071,7 +12071,7 @@ $ astfits image-a.fits --keyvalue=NAXIS,
0766af6e 472 @end example
fdaea0fb 473
0766af6e
JB
474 The output is internally stored (and finally printed) as a table (with one column per keyword).
475-Therefore just like the Table program, you can use @option{--colinfoinstdout} to print the metadata like the example below (also see @ref{Invoking asttable}).
476+Therefore just like the Table program, you can use @option{--colinfoinstdout} to print the metadata like the example below (also see @ref{asttable}).
477 The keyword metadata (comments and units) are extracted from the comments and units of the keyword in the input files (first file that has a comment or unit).
fa459b9f 478 Hence if the keyword does not have units or comments in any of the input files, they will be empty.
0766af6e 479 For more on Gnuastro's plain-text metadata format, see @ref{Gnuastro text table format}.
fa459b9f
JB
480@@ -12513,7 +12513,7 @@ $ astfits in.fits --wcsdistortion=SIP --
481 @end table
482
483
484-@node Pixel information images, , Keyword inspection and manipulation, Invoking astfits
485+@node Pixel information images, , Keyword inspection and manipulation, astfits
486 @subsubsection Pixel information images
487 In @ref{Keyword inspection and manipulation} options like @option{--pixelscale} were introduced for information on the pixels from the keywords.
488 But that only provides a single value for all the pixels!
489@@ -12614,7 +12614,7 @@ The conversion is not only one way (from
1d5db55b
JB
490 So you can also convert a JPEG image or text file into a FITS image.
491 Basically, other than EPS/PDF, you can use any of the recognized formats as different color channel inputs to get any of the recognized outputs.
2ed15334 492
fa459b9f
JB
493-Before explaining the options and arguments (in @ref{Invoking astconvertt}), we will start with a short discussion on the difference between raster and vector graphics in @ref{Raster and Vector graphics}.
494+Before explaining the options and arguments (in @ref{astconvertt}), we will start with a short discussion on the difference between raster and vector graphics in @ref{Raster and Vector graphics}.
495 In ConvertType, vector graphics are used to add markers over your originally rasterized data, producing high quality images, ready to be used in your exciting papers.
496 We will continue with a description of the recognized files types in @ref{Recognized file formats}, followed a short introduction to digital color in @ref{Color}.
497 A tutorial on how to add markers over an image is then given in @ref{Marking objects for publication} and we conclude with a @LaTeX{} based solution to add coordinates over an image.
498@@ -12625,7 +12625,7 @@ A tutorial on how to add markers over an
c34b9402 499 * Color:: Some explanations on color.
fa459b9f 500 * Color channels in same pixel grid:: When the WCS slightly differs.
91d86768 501 * Annotations for figure in paper:: Adding coordinates or physical scale.
c34b9402
JB
502-* Invoking astconvertt:: Options and arguments to ConvertType.
503+* astconvertt:: Options and arguments to ConvertType.
504 @end menu
505
fa459b9f
JB
506 @node Raster and Vector graphics, Recognized file formats, ConvertType, ConvertType
507@@ -12775,7 +12775,7 @@ Most programs also support input as plai
1d5db55b 508 As input, each plain text file is considered to contain one color channel.
c34b9402 509
1d5db55b
JB
510 In ConvertType, the recognized extensions for plain text files are @file{.txt} and @file{.dat}.
511-As described in @ref{Invoking astconvertt}, if you just give these extensions, (and not a full filename) as output, then automatic output will be preformed to determine the final output name (see @ref{Automatic output}).
512+As described in @ref{astconvertt}, if you just give these extensions, (and not a full filename) as output, then automatic output will be preformed to determine the final output name (see @ref{Automatic output}).
513 Besides these, when the format of a file cannot be recognized from its name, ConvertType will fall back to plain text mode.
514 So you can use any name (even without an extension) for a plain text input or output.
515 Just note that when the suffix is not recognized, automatic output will not be preformed.
fa459b9f
JB
516@@ -12863,8 +12863,8 @@ As a result, there is a lot of freedom i
517
518 The mapping of single-channel values to multi-channel colors is called called a ``color map''.
519 Since more information can be put in multiple channels, this usually results in better visualizing the dynamic range of your single-channel data.
1d5db55b 520-In ConvertType, you can use the @option{--colormap} option to choose between different mappings of mono-channel inputs, see @ref{Invoking astconvertt}.
fa459b9f 521-Below, we will review two of the basic color maps, please see the description of @option{--colormap} in @ref{Invoking astconvertt} for the full list.
1d5db55b 522+In ConvertType, you can use the @option{--colormap} option to choose between different mappings of mono-channel inputs, see @ref{astconvertt}.
fa459b9f 523+Below, we will review two of the basic color maps, please see the description of @option{--colormap} in @ref{astconvertt} for the full list.
2ed15334 524
fa459b9f
JB
525 @itemize
526 @item
527@@ -13000,7 +13000,7 @@ This shows how green and red channels ha
528 If you don't want to have those, or if you want the outer parts of the final image (where there was no data) to be white, some more complex commands are necessary.
529 We'll leave those as an exercise for you to try your self using @ref{Warp} and/or @ref{Crop} to pre-process the inputs before converting it to a color image.
c34b9402 530
fa459b9f
JB
531-@node Annotations for figure in paper, Invoking astconvertt, Color channels in same pixel grid, ConvertType
532+@node Annotations for figure in paper, astconvertt, Color channels in same pixel grid, ConvertType
91d86768
JB
533 @subsection Annotations for figure in paper
534
535 @cindex Image annotation
fa459b9f 536@@ -13407,7 +13407,7 @@ pdflatex -shell-escape -halt-on-error re
c34b9402 537
0766af6e 538
0766af6e 539
91d86768
JB
540-@node Invoking astconvertt, , Annotations for figure in paper, ConvertType
541+@node astconvertt, , Annotations for figure in paper, ConvertType
c34b9402
JB
542 @subsection Invoking ConvertType
543
1d5db55b 544 ConvertType will convert any recognized input file type to any specified output type.
fa459b9f
JB
545@@ -13459,7 +13459,7 @@ The common options are not repeated here
546 * Drawing with vector graphics:: Adding marks in many shapes and colors over the pixels.
547 @end menu
548
549-@node ConvertType input and output, Pixel visualization, Invoking astconvertt, Invoking astconvertt
550+@node ConvertType input and output, Pixel visualization, astconvertt, astconvertt
551 @subsubsection ConvertType input and output
552
553 @cindex Standard input
554@@ -13565,7 +13565,7 @@ If it is in color mode, some degradation
555 While the JPEG standard does support loss-less graphics, it is not commonly supported.
556 @end table
557
558-@node Pixel visualization, Drawing with vector graphics, ConvertType input and output, Invoking astconvertt
559+@node Pixel visualization, Drawing with vector graphics, ConvertType input and output, astconvertt
560 @subsubsection Pixel visualization
561
562 The main goal of ConvertType is to visualize pixels to/from print or web friendly formats.
563@@ -13697,7 +13697,7 @@ The result will be that a large are of t
564 Note that this behavior is ideal for gray-scale images, if you want a color image, the colors are going to be mixed up.
565 @end table
566
567-@node Drawing with vector graphics, , Pixel visualization, Invoking astconvertt
568+@node Drawing with vector graphics, , Pixel visualization, astconvertt
569 @subsubsection Drawing with vector graphics
570
571 With the options described in this section, you can draw marks over your to-be-published images (for example, in PDF).
572@@ -14000,18 +14000,18 @@ Table has a large set of operations that
573 For operations that Table does not do internally, FITS tables (ASCII or binary) are directly accessible to the users of Unix-like operating systems (in particular those working the command-line or shell, see @ref{Command-line interface}).
1d5db55b
JB
574 With Table, a FITS table (in binary or ASCII formats) is only one command away from AWK (or any other tool you want to use).
575 Just like a plain text file that you read with the @command{cat} command.
576-You can pipe the output of Table into any other tool for higher-level processing, see the examples in @ref{Invoking asttable} for some simple examples.
577+You can pipe the output of Table into any other tool for higher-level processing, see the examples in @ref{asttable} for some simple examples.
c34b9402 578
91d86768
JB
579 In the sections below we describe how to effectively use the Table program.
580 We start with @ref{Column arithmetic}, where the basic concept and methods of applying arithmetic operations on one or more columns are discussed.
581 Afterwards, in @ref{Operation precedence in Table}, we review the various types of operations available and their precedence in an instance of calling Table.
582 This is a good place to get a general feeling of all the things you can do with Table.
583-Finally, in @ref{Invoking asttable}, we give some examples and describe each option in Table.
584+Finally, in @ref{asttable}, we give some examples and describe each option in Table.
585
c34b9402 586 @menu
fdaea0fb 587 * Column arithmetic:: How to do operations on table columns.
91d86768 588 * Operation precedence in Table:: Order of running options in Table.
c34b9402
JB
589-* Invoking asttable:: Options and arguments to Table.
590+* asttable:: Options and arguments to Table.
591 @end menu
592
91d86768 593 @node Column arithmetic, Operation precedence in Table, Table, Table
fa459b9f
JB
594@@ -14074,7 +14074,7 @@ Column arithmetic changes the values of
595 So the old column meta data cannot be used any more.
596 By default the output column of the arithmetic operation will be given a generic metadata (for example, its name will be @code{ARITH_1}, which is hardly useful!).
37c4cc17 597 But meta data are critically important and it is good practice to always have short, but descriptive, names for each columns, units and also some comments for more explanation.
91d86768
JB
598-To add metadata to a column, you can use the @option{--colmetadata} option that is described in @ref{Invoking asttable} and @ref{Operation precedence in Table}.
599+To add metadata to a column, you can use the @option{--colmetadata} option that is described in @ref{asttable} and @ref{Operation precedence in Table}.
37c4cc17 600
fa459b9f 601 Since the arithmetic expressions are a value to @option{--column}, it does not necessarily have to be a separate option, so the commands above are also identical to the command below (note that this only has one @option{-c} option).
37c4cc17 602 Just be very careful with the quoting!
fa459b9f 603@@ -14230,13 +14230,13 @@ Other than the units of the output, this
f89484e7 604 See the description of that operator for an example.
fdaea0fb
JB
605 @end table
606
91d86768
JB
607-@node Operation precedence in Table, Invoking asttable, Column arithmetic, Table
608+@node Operation precedence in Table, asttable, Column arithmetic, Table
609 @subsection Operation precedence in Table
fdaea0fb 610
fa459b9f 611 The Table program can do many operations on the rows and columns of the input tables and they are not always applied in the order you call the operation on the command-line.
91d86768
JB
612 In this section we will describe which operation is done before/after which operation.
613 Knowing this precedence table is important to avoid confusion when you ask for more than one operation.
614-For a description of each option, please see @ref{Invoking asttable}.
615+For a description of each option, please see @ref{asttable}.
616
617 @table @asis
618 @item Column information (@option{--information} or @option{-i})
fa459b9f 619@@ -14381,7 +14381,7 @@ asttable table.fits -cRA,DEC --noblanken
91d86768
JB
620 @end example
621 @end cartouche
622
623-@node Invoking asttable, , Operation precedence in Table, Table
624+@node asttable, , Operation precedence in Table, Table
c34b9402
JB
625 @subsection Invoking Table
626
91d86768 627 Table will read/write, select, modify, or show the information of the rows and columns in recognized Table formats (including FITS binary, FITS ASCII, and plain text table files, see @ref{Tables}).
fa459b9f
JB
628@@ -14591,7 +14591,7 @@ $ asttable a.fits --catrowfile=b.fits --
629 @strong{How to avoid repetition when adding rows:} this option will simply add the rows of multiple tables into one, it does not check their contents!
f89484e7
JB
630 Therefore if you use this option on multiple catalogs that may have some shared physical objects in some of their rows, those rows/objects will be repeated in the final table.
631 In such scenarios, to avoid potential repetition, it is better to use @ref{Match} (with @option{--notmatched} and @option{--outcols=AAA,BBB}) instead of Table.
632-For more on using Match for this scenario, see the description of @option{--outcols} in @ref{Invoking astmatch}.
633+For more on using Match for this scenario, see the description of @option{--outcols} in @ref{astmatch}.
634 @end cartouche
635
636 @item -X STR
fa459b9f
JB
637@@ -14623,7 +14623,7 @@ The chosen column does not have to be in
638 This is good when you just want to select using one column's values, but do not need that column anymore afterwards.
fdaea0fb
JB
639
640 For one example of using this option, see the example under
641-@option{--sigclip-median} in @ref{Invoking aststatistics}.
642+@option{--sigclip-median} in @ref{aststatistics}.
643
84357a54
JB
644 @item --inpolygon=STR1,STR2
645 Only return rows where the given coordinates are inside the polygon specified by the @option{--polygon} option.
fa459b9f 646@@ -14938,10 +14938,10 @@ We will try to add high-level interfaces
0766af6e
JB
647
648 @menu
649 * Available databases:: List of available databases to Query.
650-* Invoking astquery:: Inputs, outputs and configuration of Query.
651+* astquery:: Inputs, outputs and configuration of Query.
652 @end menu
653
654-@node Available databases, Invoking astquery, Query, Query
655+@node Available databases, astquery, Query, Query
656 @subsection Available databases
657
658 The current list of databases supported by Query are listed at the end of this section.
fa459b9f 659@@ -15166,7 +15166,7 @@ For details on each dataset with necessa
0766af6e
JB
660
661
662
663-@node Invoking astquery, , Available databases, Query
664+@node astquery, , Available databases, Query
665 @subsection Invoking Query
666
667 Query provides a high-level interface to downloading subsets of data from databases.
fa459b9f 668@@ -15269,7 +15269,7 @@ When @option{--dataset} is specified, th
0766af6e
JB
669 Some databases (like VizieR) contain tens of thousands of datasets, so you can limit the downloaded and printed information for available databases with the @option{--limitinfo} option (described below).
670 Dataset descriptions are often large and contain a lot of text (unlike column descriptions).
671 Therefore when printing the information of all datasets within a database, the information (e.g., database name) will be printed on separate lines before the description.
672-However, when printing column information, the output has the same format as a similar option in Table (see @ref{Invoking asttable}).
673+However, when printing column information, the output has the same format as a similar option in Table (see @ref{asttable}).
674
675 Important note to consider: the printed order of the datasets or columns is just for displaying in the printed output.
676 You cannot ask for datasets or columns based on the printed order, you need to use dataset or column names.
fa459b9f 677@@ -15439,14 +15439,14 @@ So when you simply crop the image of suc
1d5db55b
JB
678 Therefore in its WCS mode, Crop will stitch parts of the tiles that are relevant for a target (with the given width) from all the input images that cover that region into the output.
679 Of course, the tiles have to be present in the list of input files.
680
681-Besides cropping postage stamps around certain coordinates, Crop can also crop arbitrary polygons from an image (or a set of tiles by stitching the relevant parts of different tiles within the polygon), see @option{--polygon} in @ref{Invoking astcrop}.
682+Besides cropping postage stamps around certain coordinates, Crop can also crop arbitrary polygons from an image (or a set of tiles by stitching the relevant parts of different tiles within the polygon), see @option{--polygon} in @ref{astcrop}.
683 Alternatively, it can crop out rectangular regions through the @option{--section} option from one image, see @ref{Crop section syntax}.
684
685 @menu
c34b9402
JB
686 * Crop modes:: Basic modes to define crop region.
687 * Crop section syntax:: How to define a section to crop.
688 * Blank pixels:: Pixels with no value.
689-* Invoking astcrop:: Calling Crop on the command-line
690+* astcrop:: Calling Crop on the command-line
691 @end menu
692
693 @node Crop modes, Crop section syntax, Crop, Crop
fa459b9f 694@@ -15468,13 +15468,13 @@ Irrespective of how the crop region is d
1d5db55b
JB
695 All coordinates are read as floating point numbers (not integers, except for the @option{--section} option, see below).
696 By setting the @emph{mode} in Crop, you define the standard that the given coordinates must be interpreted.
697 Here, the different ways to specify the crop region are discussed within each standard.
698-For the full list options, please see @ref{Invoking astcrop}.
699+For the full list options, please see @ref{astcrop}.
700
701 When the crop is defined by its center, the respective (integer) central pixel position will be found internally according to the FITS standard.
702 To have this pixel positioned in the center of the cropped region, the final cropped region will have an add number of pixels (even if you give an even number to @option{--width} in image mode).
703
fa459b9f 704 Furthermore, when the crop is defined as by its center, Crop allows you to only keep crops what do not have any blank pixels in the vicinity of their center (your primary target).
1d5db55b
JB
705-This can be very convenient when your input catalog/coordinates originated from another survey/filter which is not fully covered by your input image, to learn more about this feature, please see the description of the @option{--checkcenter} option in @ref{Invoking astcrop}.
706+This can be very convenient when your input catalog/coordinates originated from another survey/filter which is not fully covered by your input image, to learn more about this feature, please see the description of the @option{--checkcenter} option in @ref{astcrop}.
c34b9402
JB
707
708 @table @asis
709 @item Image coordinates
fa459b9f 710@@ -15501,7 +15501,7 @@ The former is lower-level (does not acce
1d5db55b 711 Please see @ref{Crop section syntax} for a full description of this method.
c34b9402 712
84357a54 713 The latter option (@option{--polygon}) is a higher-level method to define any polygon (with any number of vertices) with floating point values.
1d5db55b
JB
714-Please see the description of this option in @ref{Invoking astcrop} for its syntax.
715+Please see the description of this option in @ref{astcrop} for its syntax.
c34b9402
JB
716 @end table
717
1d5db55b 718 @item WCS coordinates
fa459b9f 719@@ -15533,7 +15533,7 @@ If it exists in the input images, it wil
1d5db55b 720
c34b9402 721 @item Vertices of a single crop
1d5db55b
JB
722 The @option{--polygon} option is a high-level method to define any convex polygon (with any number of vertices).
723-Please see the description of this option in @ref{Invoking astcrop} for its syntax.
724+Please see the description of this option in @ref{astcrop} for its syntax.
c34b9402
JB
725 @end table
726
727 @cartouche
fa459b9f 728@@ -15587,7 +15587,7 @@ If you forget the quotes, anything after
1d5db55b 729 See @ref{Command-line} for a description of how the command-line works.
c34b9402
JB
730
731
732-@node Blank pixels, Invoking astcrop, Crop section syntax, Crop
733+@node Blank pixels, astcrop, Crop section syntax, Crop
734 @subsection Blank pixels
735
736 @cindex Blank pixel
fa459b9f 737@@ -15612,7 +15612,7 @@ So by default, when dealing with float o
1d5db55b 738 This can be turned off with the @option{--zeroisnotblank} option.
c34b9402
JB
739
740
741-@node Invoking astcrop, , Blank pixels, Crop
742+@node astcrop, , Blank pixels, Crop
743 @subsection Invoking Crop
744
1d5db55b 745 Crop will crop a region from an image.
fa459b9f 746@@ -15681,7 +15681,7 @@ This has no effect on each output, see @
0766af6e 747 * Crop known issues:: Known issues in running Crop.
c34b9402
JB
748 @end menu
749
750-@node Crop options, Crop output, Invoking astcrop, Invoking astcrop
751+@node Crop options, Crop output, astcrop, astcrop
752 @subsubsection Crop options
753
1d5db55b 754 The options can be classified into the following contexts: Input, Output and operating mode options.
fa459b9f 755@@ -15947,7 +15947,7 @@ The value must either be @option{img} or
c34b9402
JB
756
757
758
0766af6e
JB
759-@node Crop output, Crop known issues, Crop options, Invoking astcrop
760+@node Crop output, Crop known issues, Crop options, astcrop
c34b9402
JB
761 @subsubsection Crop output
762
fa459b9f
JB
763 The string given to @option{--output} option will be interpreted depending on how many crops were requested, see @ref{Crop modes}:
764@@ -15988,7 +15988,7 @@ The cropped image file name for that row
1d5db55b
JB
765 The number of input images that were used to create that image.
766 @item
fa459b9f 767 A @code{0} if the central few pixels (value to the @option{--checkcenter} option) are blank and @code{1} if they are not.
1d5db55b
JB
768-When the crop was not defined by its center (see @ref{Crop modes}), or @option{--checkcenter} was given a value of 0 (see @ref{Invoking astcrop}), the center will not be checked and this column will be given a value of @code{-1}.
769+When the crop was not defined by its center (see @ref{Crop modes}), or @option{--checkcenter} was given a value of 0 (see @ref{astcrop}), the center will not be checked and this column will be given a value of @code{-1}.
c34b9402
JB
770 @end enumerate
771
fa459b9f
JB
772 If the output crop(s) have a single element (pixel in an image) and @option{--oneelemstdout} has been called, no output file will be produced!
773@@ -16018,7 +16018,7 @@ In other words, the file in the first co
774 @end table
775
776
0766af6e
JB
777-@node Crop known issues, , Crop output, Invoking astcrop
778+@node Crop known issues, , Crop output, astcrop
779 @subsubsection Crop known issues
1d5db55b 780
0766af6e 781 When running Crop, you may encounter strange errors and bugs.
fa459b9f 782@@ -16068,14 +16068,14 @@ For example, in the reduction of raw dat
1d5db55b
JB
783 Later (once the images as warped into a single grid using Warp for example, see @ref{Warp}), the images are co-added (the output pixel grid is the average of the pixels of the individual input images).
784 Arithmetic is Gnuastro's program for such operations on your datasets directly from the command-line.
785 It currently uses the reverse polish or post-fix notation, see @ref{Reverse polish notation} and will work on the native data types of the input images/data to reduce CPU and RAM resources, see @ref{Numeric data types}.
786-For more information on how to run Arithmetic, please see @ref{Invoking astarithmetic}.
787+For more information on how to run Arithmetic, please see @ref{astarithmetic}.
c34b9402
JB
788
789
790 @menu
791 * Reverse polish notation:: The current notation style for Arithmetic
f89484e7 792 * Integer benefits and pitfalls:: Integers have major benefits, but require care
c34b9402
JB
793 * Arithmetic operators:: List of operators known to Arithmetic
794-* Invoking astarithmetic:: How to run Arithmetic: options and output
795+* astarithmetic:: How to run Arithmetic: options and output
796 @end menu
797
f89484e7 798 @node Reverse polish notation, Integer benefits and pitfalls, Arithmetic, Arithmetic
fa459b9f 799@@ -16153,7 +16153,7 @@ There are no more operands or operators,
91d86768 800 In the kitchen metaphor, you see that your recipe has no more steps, so you just pick up the remaining dish and take it to the dining room to enjoy a good dinner.
fdaea0fb
JB
801 @end enumerate
802
91d86768
JB
803-In the Arithmetic program, the operands can be FITS images of any dimensionality, or numbers (see @ref{Invoking astarithmetic}).
804+In the Arithmetic program, the operands can be FITS images of any dimensionality, or numbers (see @ref{astarithmetic}).
805 In Table's column arithmetic, they can be any column in the table (a series of numbers in an array) or a single number (see @ref{Column arithmetic}).
fdaea0fb 806
1d5db55b 807 With this notation, very complicated procedures can be created without the need for parenthesis or worrying about precedence.
fa459b9f
JB
808@@ -16251,7 +16251,7 @@ It is possible to do internal checks in
809 However, we have not opted for this solution because all those checks will consume significant resources and slow down the program (especially with large datasets where RAM, storage and running time become important).
f89484e7 810 To be optimal, we therefore trust that you (the wise Gnuastro user!) make the appropriate type conversion in your commands where necessary (recall that the operators are available in @ref{Numerical type conversion operators}).
c34b9402 811
f89484e7
JB
812-@node Arithmetic operators, Invoking astarithmetic, Integer benefits and pitfalls, Arithmetic
813+@node Arithmetic operators, astarithmetic, Integer benefits and pitfalls, Arithmetic
c34b9402
JB
814 @subsection Arithmetic operators
815
91d86768 816 In this section, list of recognized operators in Arithmetic (and the Table program's @ref{Column arithmetic}) and discussed in detail with examples.
fa459b9f 817@@ -18112,7 +18112,7 @@ Similar to the @code{tofile} operator, w
91d86768 818 @end table
c34b9402
JB
819
820
821-@node Invoking astarithmetic, , Arithmetic operators, Arithmetic
822+@node astarithmetic, , Arithmetic operators, Arithmetic
823 @subsection Invoking Arithmetic
824
1d5db55b 825 Arithmetic will do pixel to pixel arithmetic operations on the individual pixels of input data and/or numbers.
fa459b9f 826@@ -18337,7 +18337,7 @@ $ echo "" | awk '@{print (10.32-3.84)^2.
1d5db55b
JB
827 @cindex Average, weighted
828 @cindex Kernel, convolution
829 On an image, convolution can be thought of as a process to blur or remove the contrast in an image.
830-If you are already familiar with the concept and just want to run Convolve, you can jump to @ref{Convolution kernel} and @ref{Invoking astconvolve} and skip the lengthy introduction on the basic definitions and concepts of convolution.
831+If you are already familiar with the concept and just want to run Convolve, you can jump to @ref{Convolution kernel} and @ref{astconvolve} and skip the lengthy introduction on the basic definitions and concepts of convolution.
832
833 There are generally two methods to convolve an image.
834 The first and more intuitive one is in the ``spatial domain'' or using the actual image pixel values, see @ref{Spatial domain convolution}.
fa459b9f 835@@ -18368,7 +18368,7 @@ However this text is written for an unde
c34b9402
JB
836 * Frequency domain and Fourier operations:: Using frequencies in input.
837 * Spatial vs. Frequency domain:: When to use which?
838 * Convolution kernel:: How to specify the convolution kernel.
839-* Invoking astconvolve:: Options and argument to Convolve.
840+* astconvolve:: Options and argument to Convolve.
841 @end menu
842
843 @node Spatial domain convolution, Frequency domain and Fourier operations, Convolve, Convolve
fa459b9f 844@@ -19112,7 +19112,7 @@ The reason is that if you apply a freque
1d5db55b
JB
845 But when you have made the profiles in the image yourself, you can just make a larger input image and crop the central parts to completely remove the edge effect, see @ref{If convolving afterwards}.
846 Also due to oversampling, both the kernels and the images can become very large and the speed boost of frequency domain convolution will significantly improve the processing time, see @ref{Oversampling}.
c34b9402
JB
847
848-@node Convolution kernel, Invoking astconvolve, Spatial vs. Frequency domain, Convolve
849+@node Convolution kernel, astconvolve, Spatial vs. Frequency domain, Convolve
850 @subsection Convolution kernel
851
1d5db55b 852 All the programs that need convolution will need to be given a convolution kernel file and extension.
fa459b9f 853@@ -19130,7 +19130,7 @@ By default MakeProfiles will make the Ga
1d5db55b
JB
854 ConvertType: You can write your own desired kernel into a text file table and convert it to a FITS file with ConvertType, see @ref{ConvertType}.
855 Just be careful that the kernel has to have an odd number of pixels along its two axes, see @ref{Convolution process}.
fa459b9f 856 All the programs that do convolution will normalize the kernel internally, so if you choose this option, you do not have to worry about normalizing the kernel.
1d5db55b
JB
857-Only within Convolve, there is an option to disable normalization, see @ref{Invoking astconvolve}.
858+Only within Convolve, there is an option to disable normalization, see @ref{astconvolve}.
c34b9402
JB
859
860 @end itemize
861
fa459b9f 862@@ -19170,7 +19170,7 @@ By default, the system configuration fil
c34b9402
JB
863 @end table
864
865
866-@node Invoking astconvolve, , Convolution kernel, Convolve
867+@node astconvolve, , Convolution kernel, Convolve
868 @subsection Invoking Convolve
869
1d5db55b 870 Convolve an input dataset (2D image or 1D spectrum for example) with a known kernel, or make the kernel necessary to match two PSFs.
fa459b9f 871@@ -19395,7 +19395,7 @@ It is therefore necessary to warp the im
c34b9402
JB
872 * Merging multiple warpings:: How to merge multiple matrices.
873 * Resampling:: Warping an image is re-sampling it.
fa459b9f 874 * Moire pattern and its correction:: Spatial resonance of the grid pattern on output.
c34b9402
JB
875-* Invoking astwarp:: Arguments and options for Warp.
876+* astwarp:: Arguments and options for Warp.
877 @end menu
878
fa459b9f
JB
879 @node Linear warping basics, Merging multiple warpings, Warp, Warp
880@@ -19616,7 +19616,7 @@ However, when a non-linear distortion (f
881 To account for such cases (which can only happen when correcting for non-linear distortions), Warp has the @option{--edgesampling} option to sample the output pixel over more vertices.
882 For more, see the description of this option in @ref{Align pixels with WCS considering distortions}.
c34b9402 883
fa459b9f
JB
884-@node Moire pattern and its correction, Invoking astwarp, Resampling, Warp
885+@node Moire pattern and its correction, astwarp, Resampling, Warp
886 @subsection Moir@'e pattern and its correction
c34b9402 887
fa459b9f
JB
888 @cindex Moir@'e pattern or fringes
889@@ -19838,7 +19838,7 @@ For example if you only have two dither
890 Ideally, many more dither points should be chosen when you are planning your observation (not just for the Moir@'e pattern, but also for all the other reasons mentioned above).
891 Based on the dithering pattern, you want to select the increased resolution such that the maximum @code{MAX-FRAC} values fall on every different pixel of the output grid for each exposure.
c34b9402 892
fa459b9f
JB
893-@node Invoking astwarp, , Moire pattern and its correction, Warp
894+@node astwarp, , Moire pattern and its correction, Warp
c34b9402
JB
895 @subsection Invoking Warp
896
fa459b9f
JB
897 Warp an input image into a new pixel grid by pixel mixing (see @ref{Resampling}).
898@@ -19911,10 +19911,10 @@ The following options are shared between
c34b9402 899
fa459b9f 900 @table @option
c34b9402 901 @item --hstartwcs=INT
1d5db55b
JB
902-Specify the first header keyword number (line) that should be used to read the WCS information, see the full explanation in @ref{Invoking astcrop}.
903+Specify the first header keyword number (line) that should be used to read the WCS information, see the full explanation in @ref{astcrop}.
c34b9402
JB
904
905 @item --hendwcs=INT
1d5db55b
JB
906-Specify the last header keyword number (line) that should be used to read the WCS information, see the full explanation in @ref{Invoking astcrop}.
907+Specify the last header keyword number (line) that should be used to read the WCS information, see the full explanation in @ref{astcrop}.
c34b9402 908
fa459b9f
JB
909 @item -C FLT
910 @itemx --coveredfrac=FLT
911@@ -19930,7 +19930,7 @@ As a result, with @option{--coveredfrac=
912 * Linear warps to be called explicitly:: Other warps.
913 @end menu
914
915-@node Align pixels with WCS considering distortions, Linear warps to be called explicitly, Invoking astwarp, Invoking astwarp
916+@node Align pixels with WCS considering distortions, Linear warps to be called explicitly, astwarp, astwarp
917 @subsubsection Align pixels with WCS considering distortions
918
919 @cindex Resampling
920@@ -20198,7 +20198,7 @@ On the other hand, 0 means that the pixe
921
922
923
924-@node Linear warps to be called explicitly, , Align pixels with WCS considering distortions, Invoking astwarp
925+@node Linear warps to be called explicitly, , Align pixels with WCS considering distortions, astwarp
926 @subsubsection Linear warps to be called explicitly
927
928 Linear warps include operations like rotation, scaling, sheer, etc.
929@@ -20362,7 +20362,7 @@ The Statistics program is designed for s
c34b9402 930 * Sigma clipping:: Definition of @mymath{\sigma}-clipping.
fa459b9f 931 * Least squares fitting:: Fitting with various parametric functions.
c34b9402
JB
932 * Sky value:: Definition and derivation of the Sky value.
933-* Invoking aststatistics:: Arguments and options to Statistics.
934+* aststatistics:: Arguments and options to Statistics.
935 @end menu
936
937
fa459b9f 938@@ -20376,7 +20376,7 @@ So on the horizontal axis we have the bi
1d5db55b
JB
939 You can use it to get a general view of the distribution: which values have been repeated the most? how close/far are the most significant bins? Are there more values in the larger part of the range of the dataset, or in the lower part? Similarly, many very important properties about the dataset can be deduced from a visual inspection of the histogram.
940 In the Statistics program, the histogram can be either output to a table to plot with your favorite plotting program@footnote{
941 We recommend @url{http://pgfplots.sourceforge.net/,PGFPlots} which generates your plots directly within @TeX{} (the same tool that generates your document).},
942-or it can be shown with ASCII characters on the command-line, which is very crude, but good enough for a fast and on-the-go analysis, see the example in @ref{Invoking aststatistics}.
943+or it can be shown with ASCII characters on the command-line, which is very crude, but good enough for a fast and on-the-go analysis, see the example in @ref{aststatistics}.
c34b9402
JB
944
945 @cindex Intervals, histogram
946 @cindex Bin width, histogram
fa459b9f 947@@ -20397,7 +20397,7 @@ Normalizing a cumulative frequency plot
1d5db55b 948 Unlike the histogram which has a limited number of bins, ideally the cumulative frequency plot should have one point for every data element.
fa459b9f 949 Even in small datasets (for example, a @mymath{200\times200} image) this will result in an unreasonably large number of points to plot (40000)! As a result, for practical reasons, it is common to only store its value on a certain number of points (intervals) in the input range rather than the whole dataset, so you should determine the number of bins you want when asking for a cumulative frequency plot.
1d5db55b
JB
950 In Gnuastro (and thus the Statistics program), the number reported for each bin is the total number of data points until the larger interval value for that bin.
951-You can see an example histogram and cumulative frequency plot of a single dataset under the @option{--asciihist} and @option{--asciicfp} options of @ref{Invoking aststatistics}.
952+You can see an example histogram and cumulative frequency plot of a single dataset under the @option{--asciihist} and @option{--asciicfp} options of @ref{aststatistics}.
c34b9402 953
1d5db55b
JB
954 So as a summary, both the histogram and cumulative frequency plot in Statistics will work with bins.
955 Within each bin/interval, the lower value is considered to be within then bin (it is inclusive), but its larger value is not (it is exclusive).
fa459b9f
JB
956@@ -20967,7 +20967,7 @@ GSL provides many methods to reject outl
957 For their full list, see the description of @option{--fitrobust} in @ref{Fitting options}.
958 For a description of the outlier rejection methods, see the @url{https://www.gnu.org/software/gsl/doc/html/lls.html#c.gsl_multifit_robust_workspace, GSL manual}.
c34b9402 959
fa459b9f
JB
960-@node Sky value, Invoking aststatistics, Least squares fitting, Statistics
961+@node Sky value, aststatistics, Least squares fitting, Statistics
c34b9402
JB
962 @subsection Sky value
963
964 @cindex Sky
fa459b9f 965@@ -21225,7 +21225,7 @@ The same goes for the @option{--checksky
c34b9402
JB
966
967
968
969-@node Invoking aststatistics, , Sky value, Statistics
970+@node aststatistics, , Sky value, Statistics
971 @subsection Invoking Statistics
972
1d5db55b 973 Statistics will print statistical measures of an input dataset (table column or image).
fa459b9f
JB
974@@ -21345,7 +21345,7 @@ If you want another statistical paramete
975 * Statistics on tiles:: Possible to do single-valued measurements on tiles.
976 @end menu
977
978-@node Input to Statistics, Single value measurements, Invoking aststatistics, Invoking aststatistics
979+@node Input to Statistics, Single value measurements, aststatistics, aststatistics
980 @subsubsection Input to Statistics
981
982 The following set of options are for specifying the input/outputs of Statistics.
983@@ -21386,7 +21386,7 @@ The quantile of each horizontal axis val
984
985 @end table
986
987-@node Single value measurements, Generating histograms and cumulative frequency plots, Input to Statistics, Invoking aststatistics
988+@node Single value measurements, Generating histograms and cumulative frequency plots, Input to Statistics, aststatistics
989 @subsubsection Single value measurements
990
991 @table @option
992@@ -21543,7 +21543,7 @@ Standard deviation after applying @mymat
993
994 @end table
995
996-@node Generating histograms and cumulative frequency plots, Fitting options, Single value measurements, Invoking aststatistics
997+@node Generating histograms and cumulative frequency plots, Fitting options, Single value measurements, aststatistics
998 @subsubsection Generating histograms and cumulative freq.
999
1000 The list of options below are for those statistical operations that output more than one value.
1001@@ -21711,7 +21711,7 @@ Similar to @option{--onebinstart}, but f
1002
1003 @end table
1004
1005-@node Fitting options, Contour options, Generating histograms and cumulative frequency plots, Invoking aststatistics
1006+@node Fitting options, Contour options, Generating histograms and cumulative frequency plots, aststatistics
1007 @subsubsection Fitting options
1008
1009 With the options below, you can customize the least squares fitting features of Statistics.
1010@@ -21879,7 +21879,7 @@ See @ref{Selecting table columns}.
1011
1012
1013
1014-@node Contour options, Statistics on tiles, Fitting options, Invoking aststatistics
1015+@node Contour options, Statistics on tiles, Fitting options, aststatistics
1016 @subsubsection Contour options
1017
1018 Contours are useful to highlight the 2D shape of a certain flux level over an image.
1019@@ -21901,7 +21901,7 @@ If the image has World Coordinate System
1020 Note that currently, this is a very crude/simple implementation, please let us know if you find problematic situations so we can fix it.
1021 @end table
1022
1023-@node Statistics on tiles, , Contour options, Invoking aststatistics
1024+@node Statistics on tiles, , Contour options, aststatistics
1025 @subsubsection Statistics on tiles
1026
1027 All the options described until now were from the first class of operations discussed above: those that treat the whole dataset as one.
1028@@ -22055,7 +22055,7 @@ You can then directly feed NoiseChisel's
1d5db55b 1029 Thanks to the published papers mentioned above, there is no need to provide a more complete introduction to NoiseChisel in this book.
0766af6e
JB
1030 However, published papers cannot be updated any more, but the software has evolved/changed.
1031 The changes since publication are documented in @ref{NoiseChisel changes after publication}.
1d5db55b
JB
1032-In @ref{Invoking astnoisechisel}, the details of running NoiseChisel and its options are discussed.
1033+In @ref{astnoisechisel}, the details of running NoiseChisel and its options are discussed.
1034
1035 As discussed above, detection is one of the most important steps for your scientific result.
1036 It is therefore very important to obtain a good understanding of NoiseChisel (and afterwards @ref{Segment} and @ref{MakeCatalog}).
fa459b9f 1037@@ -22067,17 +22067,17 @@ In the meantime, they also show the modu
1d5db55b
JB
1038 Defining colors is a very common process in most science-cases.
1039 Therefore it is also recommended to (patiently) complete that tutorial for optimal usage of NoiseChisel in conjunction with all the other Gnuastro programs.
1040 @ref{Detecting large extended targets} shows you can optimize NoiseChisel's settings for very extended objects to successfully carve out to signal-to-noise ratio levels of below 1/10.
1041-After going through those tutorials, play a little with the settings (in the order presented in the paper and @ref{Invoking astnoisechisel}) on a dataset you are familiar with and inspect all the check images (options starting with @option{--check}) to see the effect of each parameter.
1042+After going through those tutorials, play a little with the settings (in the order presented in the paper and @ref{astnoisechisel}) on a dataset you are familiar with and inspect all the check images (options starting with @option{--check}) to see the effect of each parameter.
1043
1044-Below, in @ref{Invoking astnoisechisel}, we will review NoiseChisel's input, detection, and output options in @ref{NoiseChisel input}, @ref{Detection options}, and @ref{NoiseChisel output}.
1045+Below, in @ref{astnoisechisel}, we will review NoiseChisel's input, detection, and output options in @ref{NoiseChisel input}, @ref{Detection options}, and @ref{NoiseChisel output}.
1046 If you have used NoiseChisel within your research, please run it with @option{--cite} to list the papers you should cite and how to acknowledge its funding sources.
c34b9402
JB
1047
1048 @menu
0766af6e 1049 * NoiseChisel changes after publication:: Updates since published papers.
c34b9402
JB
1050-* Invoking astnoisechisel:: Options and arguments for NoiseChisel.
1051+* astnoisechisel:: Options and arguments for NoiseChisel.
1052 @end menu
1053
0766af6e
JB
1054-@node NoiseChisel changes after publication, Invoking astnoisechisel, NoiseChisel, NoiseChisel
1055+@node NoiseChisel changes after publication, astnoisechisel, NoiseChisel, NoiseChisel
1056 @subsection NoiseChisel changes after publication
c34b9402 1057
0766af6e 1058 NoiseChisel was initially introduced in @url{https://arxiv.org/abs/1505.01664, Akhlaghi and Ichikawa [2015]} and updates after the first four years were published in @url{https://arxiv.org/abs/1909.11230, Akhlaghi [2019]}.
fa459b9f 1059@@ -22105,7 +22105,7 @@ In our tests, this gave a much improved
c34b9402 1060
635d3ed9 1061
1d5db55b 1062
0766af6e
JB
1063-@node Invoking astnoisechisel, , NoiseChisel changes after publication, NoiseChisel
1064+@node astnoisechisel, , NoiseChisel changes after publication, NoiseChisel
c34b9402
JB
1065 @subsection Invoking NoiseChisel
1066
1d5db55b 1067 NoiseChisel will detect signal in noise producing a multi-extension dataset containing a binary detection map which is the same size as the input.
fa459b9f 1068@@ -22232,7 +22232,7 @@ Finally, in @ref{NoiseChisel output} the
635d3ed9 1069 * NoiseChisel output:: NoiseChisel's output options and format.
c34b9402
JB
1070 @end menu
1071
635d3ed9
JB
1072-@node NoiseChisel input, Detection options, Invoking astnoisechisel, Invoking astnoisechisel
1073+@node NoiseChisel input, Detection options, astnoisechisel, astnoisechisel
1074 @subsubsection NoiseChisel input
c34b9402 1075
1d5db55b 1076 The options here can be used to configure the inputs and output of NoiseChisel, along with some general processing options.
fa459b9f 1077@@ -22336,7 +22336,7 @@ Except for the tile size, all the other
1d5db55b 1078 The format is identical to that of the @option{--tilesize} option that is discussed in that section.
c34b9402
JB
1079 @end table
1080
635d3ed9
JB
1081-@node Detection options, NoiseChisel output, NoiseChisel input, Invoking astnoisechisel
1082+@node Detection options, NoiseChisel output, NoiseChisel input, astnoisechisel
c34b9402
JB
1083 @subsubsection Detection options
1084
1d5db55b 1085 Detection is the process of separating the pixels in the image into two groups: 1) Signal, and 2) Noise.
fa459b9f 1086@@ -22679,7 +22679,7 @@ By default the output will have the same
c34b9402
JB
1087
1088
c34b9402 1089
635d3ed9
JB
1090-@node NoiseChisel output, , Detection options, Invoking astnoisechisel
1091+@node NoiseChisel output, , Detection options, astnoisechisel
1092 @subsubsection NoiseChisel output
1093
1d5db55b 1094 NoiseChisel's output is a multi-extension FITS file.
fa459b9f
JB
1095@@ -22850,14 +22850,14 @@ Those papers cannot be updated any more
1096 for example, Segment became a separate program (from NoiseChisel) in 2018 (after those papers were published).
1d5db55b
JB
1097 Therefore this book is the definitive reference.
1098 @c To help in the transition from those papers to the software you are using, see @ref{Segment changes after publication}.
fa459b9f
JB
1099-Finally, in @ref{Invoking astsegment}, we will discuss Segment's inputs, outputs and configuration options.
1100+Finally, in @ref{astsegment}, we will discuss Segment's inputs, outputs and configuration options.
635d3ed9
JB
1101
1102
1103 @menu
635d3ed9
JB
1104-* Invoking astsegment:: Inputs, outputs and options to Segment
1105+* astsegment:: Inputs, outputs and options to Segment
1106 @end menu
1107
1d5db55b
JB
1108-@c @node Segment changes after publication, Invoking astsegment, Segment, Segment
1109+@c @node Segment changes after publication, astsegment, Segment, Segment
1110 @c @subsection Segment changes after publication
635d3ed9 1111
1d5db55b 1112 @c Segment's main algorithm and working strategy were initially defined and introduced in Section 3.2 of @url{https://arxiv.org/abs/1505.01664, Akhlaghi and Ichikawa [2015]} and @url{https://arxiv.org/abs/1909.11230, Akhlaghi [2019]}.
fa459b9f 1113@@ -22869,7 +22869,7 @@ Finally, in @ref{Invoking astsegment}, w
1d5db55b
JB
1114 @c The aim of this section is to make the transition from the paper to your installed version, as smooth as possible through the list below.
1115 @c For a more detailed list of changes in previous Gnuastro releases/versions, please follow the @file{NEWS} file@footnote{The @file{NEWS} file is present in the released Gnuastro tarball, see @ref{Release tarball}.}.
635d3ed9 1116
1d5db55b
JB
1117-@node Invoking astsegment, , Segment, Segment
1118+@node astsegment, , Segment, Segment
635d3ed9
JB
1119 @subsection Invoking Segment
1120
1d5db55b 1121 Segment will identify substructure within the detected regions of an input image.
fa459b9f 1122@@ -22922,7 +22922,7 @@ Finally, in @ref{Segment output}, we wil
635d3ed9
JB
1123 * Segment output:: Outputs of Segment
1124 @end menu
1125
1126-@node Segment input, Segmentation options, Invoking astsegment, Invoking astsegment
1127+@node Segment input, Segmentation options, astsegment, astsegment
1128 @subsubsection Segment input
1129
fa459b9f
JB
1130 Besides the input dataset (for example, astronomical image), Segment also needs to know the Sky standard deviation and the regions of the dataset that it should segment.
1131@@ -23064,7 +23064,7 @@ It is important for them to be much larg
c34b9402
JB
1132 @end table
1133
1134
635d3ed9
JB
1135-@node Segmentation options, Segment output, Segment input, Invoking astsegment
1136+@node Segmentation options, Segment output, Segment input, astsegment
1137 @subsubsection Segmentation options
1138
1d5db55b 1139 The options below can be used to configure every step of the segmentation process in the Segment program.
fa459b9f 1140@@ -23178,7 +23178,7 @@ This behavior can be disabled with @opti
635d3ed9
JB
1141
1142 @end table
c34b9402 1143
635d3ed9
JB
1144-@node Segment output, , Segmentation options, Invoking astsegment
1145+@node Segment output, , Segmentation options, astsegment
1146 @subsubsection Segment output
1147
1d5db55b 1148 The main output of Segment are two label datasets (with integer types, separating the dataset's elements into different classes).
fa459b9f 1149@@ -23322,7 +23322,7 @@ Similarly, the sum of all these pixels w
1d5db55b
JB
1150 Pixels with labels equal to, or smaller than, zero will be ignored by MakeCatalog.
1151 In other words, the number of rows in MakeCatalog's output is already known before running it (the maximum value of the labeled dataset).
1152
fa459b9f
JB
1153-Before getting into the details of running MakeCatalog (in @ref{Invoking astmkcatalog}, we will start with a discussion on the basics of its approach to separating detection from measurements in @ref{Detection and catalog production}.
1154+Before getting into the details of running MakeCatalog (in @ref{astmkcatalog}, we will start with a discussion on the basics of its approach to separating detection from measurements in @ref{Detection and catalog production}.
1d5db55b 1155 A very important factor in any measurement is understanding its validity range, or limits.
fa459b9f 1156 Therefore in @ref{Quantifying measurement limits}, we will discuss how to estimate the reliability of the detection and basic measurements.
1d5db55b 1157 This section will continue with a derivation of elliptical parameters from the labeled datasets in @ref{Measuring elliptical parameters}.
fa459b9f 1158@@ -23334,7 +23334,7 @@ For those who feel MakeCatalog's existin
c34b9402
JB
1159 * Quantifying measurement limits:: For comparing different catalogs.
1160 * Measuring elliptical parameters:: Estimating elliptical parameters.
1161 * Adding new columns to MakeCatalog:: How to add new columns.
1162-* Invoking astmkcatalog:: Options and arguments to MakeCatalog.
1163+* astmkcatalog:: Options and arguments to MakeCatalog.
1164 @end menu
1165
0766af6e 1166 @node Detection and catalog production, Brightness flux magnitude, MakeCatalog, MakeCatalog
fa459b9f 1167@@ -23926,7 +23926,7 @@ When the object cannot be represented as
c34b9402
JB
1168
1169
1170
1171-@node Adding new columns to MakeCatalog, Invoking astmkcatalog, Measuring elliptical parameters, MakeCatalog
1172+@node Adding new columns to MakeCatalog, astmkcatalog, Measuring elliptical parameters, MakeCatalog
1173 @subsection Adding new columns to MakeCatalog
1174
1d5db55b 1175 MakeCatalog is designed to allow easy addition of different measurements over a labeled image (see @url{https://arxiv.org/abs/1611.06387v1, Akhlaghi [2016]}).
fa459b9f 1176@@ -23942,7 +23942,7 @@ These two passes are designed to be raw
1d5db55b
JB
1177 This will allow parallel processing and simplicity/clarity.
1178 So if your new calculation, needs new raw information from the pixels, then you will need to also modify the respective @code{mkcatalog_first_pass} and @code{mkcatalog_second_pass} functions (both in @file{bin/mkcatalog/mkcatalog.c}) and define new raw table columns in @file{main.h} (hopefully the comments in the code are clear enough).
1179
1180-In all these different places, the final columns are sorted in the same order (same order as @ref{Invoking astmkcatalog}).
1181+In all these different places, the final columns are sorted in the same order (same order as @ref{astmkcatalog}).
1182 This allows a particular column/option to be easily found in all steps.
fa459b9f 1183 Therefore in adding your new option, be sure to keep it in the same relative place in the list in all the separate places (it does not necessarily have to be in the end), and near conceptually similar options.
c34b9402 1184
fa459b9f 1185@@ -23994,7 +23994,7 @@ Update this manual and add a description
c34b9402
JB
1186
1187
1188
1189-@node Invoking astmkcatalog, , Adding new columns to MakeCatalog, MakeCatalog
1190+@node astmkcatalog, , Adding new columns to MakeCatalog, MakeCatalog
1191 @subsection Invoking MakeCatalog
1192
1d5db55b 1193 MakeCatalog will do measurements and produce a catalog from a labeled dataset and optional values dataset(s).
fa459b9f 1194@@ -24048,7 +24048,7 @@ Finally, in @ref{MakeCatalog output} the
2ed15334 1195 * MakeCatalog output:: File names of MakeCatalog's output table.
c34b9402
JB
1196 @end menu
1197
635d3ed9
JB
1198-@node MakeCatalog inputs and basic settings, Upper-limit settings, Invoking astmkcatalog, Invoking astmkcatalog
1199+@node MakeCatalog inputs and basic settings, Upper-limit settings, astmkcatalog, astmkcatalog
1200 @subsubsection MakeCatalog inputs and basic settings
1201
1d5db55b 1202 MakeCatalog works by using a localized/labeled dataset (see @ref{MakeCatalog}).
fa459b9f 1203@@ -24102,7 +24102,7 @@ In such cases, you can use Gnuastro's Ar
1d5db55b
JB
1204 @end example
1205
fa459b9f 1206 To summarize: if the input file to MakeCatalog is the default/full output of Segment (see @ref{Segment output}) you do not have to worry about any of the @option{--*file} options below.
1d5db55b
JB
1207-You can just give Segment's output file to MakeCatalog as described in @ref{Invoking astmkcatalog}.
1208+You can just give Segment's output file to MakeCatalog as described in @ref{astmkcatalog}.
1209 To feed NoiseChisel's output into MakeCatalog, just change the labeled dataset's header (with @option{--hdu=DETECTIONS}).
1210 The full list of input dataset options and general setting options are described below.
1211
fa459b9f 1212@@ -24201,7 +24201,7 @@ But in practice real images my be over-s
91d86768 1213
c34b9402
JB
1214
1215
2ed15334
JB
1216-@node Upper-limit settings, MakeCatalog measurements, MakeCatalog inputs and basic settings, Invoking astmkcatalog
1217+@node Upper-limit settings, MakeCatalog measurements, MakeCatalog inputs and basic settings, astmkcatalog
635d3ed9 1218 @subsubsection Upper-limit settings
c34b9402 1219
1d5db55b 1220 The upper-limit magnitude was discussed in @ref{Quantifying measurement limits}.
fa459b9f 1221@@ -24288,7 +24288,7 @@ The total number of rows is thus unknown
c34b9402
JB
1222 @end table
1223
1224
2ed15334
JB
1225-@node MakeCatalog measurements, MakeCatalog output, Upper-limit settings, Invoking astmkcatalog
1226+@node MakeCatalog measurements, MakeCatalog output, Upper-limit settings, astmkcatalog
1227 @subsubsection MakeCatalog measurements
c34b9402 1228
1d5db55b 1229 The final group of options particular to MakeCatalog are those that specify which measurements/columns should be written into the final output table.
fa459b9f 1230@@ -24849,7 +24849,7 @@ If you use this option, it will have 13
c34b9402 1231
c34b9402
JB
1232
1233
2ed15334
JB
1234-@node MakeCatalog output, , MakeCatalog measurements, Invoking astmkcatalog
1235+@node MakeCatalog output, , MakeCatalog measurements, astmkcatalog
1236 @subsubsection MakeCatalog output
1d5db55b
JB
1237 After it has completed all the requested measurements (see @ref{MakeCatalog measurements}), MakeCatalog will store its measurements in table(s).
1238 If an output filename is given (see @option{--output} in @ref{Input output options}), the format of the table will be deduced from the name.
fa459b9f 1239@@ -24974,10 +24974,10 @@ The aperture can be a circle or an ellip
c34b9402
JB
1240
1241 @menu
f89484e7 1242 * Matching algorithms:: Different ways to find the match
c34b9402
JB
1243-* Invoking astmatch:: Inputs, outputs and options of Match
1244+* astmatch:: Inputs, outputs and options of Match
1245 @end menu
1246
f89484e7
JB
1247-@node Matching algorithms, Invoking astmatch, Match, Match
1248+@node Matching algorithms, astmatch, Match, Match
1249 @subsection Matching algorithms
1250
1251 Matching involves two catalogs, let's call them catalog A (with N rows) and catalog B (with M rows).
fa459b9f 1252@@ -25090,7 +25090,7 @@ If you always need to match against one
f89484e7
JB
1253 Therefore you can save its k-d tree into a file and simply give it to later calls, like the example given in the description of the k-d algorithm mentioned above.
1254 @end itemize
1255
1256-@node Invoking astmatch, , Matching algorithms, Match
1257+@node astmatch, , Matching algorithms, Match
c34b9402
JB
1258 @subsection Invoking Match
1259
1d5db55b 1260 When given two catalogs, Match finds the rows that are nearest to each other within an input aperture.
fa459b9f 1261@@ -25476,7 +25476,7 @@ After all the transformations are applie
0766af6e 1262 * Modeling basics:: Astronomical modeling basics.
c34b9402 1263 * If convolving afterwards:: Considerations for convolving later.
c34b9402
JB
1264 * Profile magnitude:: Definition of total profile magnitude.
1265-* Invoking astmkprof:: Inputs and Options for MakeProfiles.
1266+* astmkprof:: Inputs and Options for MakeProfiles.
1267 @end menu
1268
1269
fa459b9f 1270@@ -25806,7 +25806,7 @@ You also have to shift all the pixel pos
c34b9402 1271
fa459b9f 1272 After convolution, you can crop the outer @mymath{n} pixels with the section crop box specification of Crop: @option{--section=n+1:*-n,n+1:*-n} (according to the FITS standard, counting is from 1 so we use @code{n+1}) assuming your PSF is a square, see @ref{Crop section syntax}.
1d5db55b
JB
1273 This will also remove all discrete Fourier transform artifacts (blurred sides) from the final image.
1274-To facilitate this shift, MakeProfiles has the options @option{--xshift}, @option{--yshift} and @option{--prepforconv}, see @ref{Invoking astmkprof}.
1275+To facilitate this shift, MakeProfiles has the options @option{--xshift}, @option{--yshift} and @option{--prepforconv}, see @ref{astmkprof}.
c34b9402
JB
1276
1277
1d5db55b 1278
fa459b9f 1279@@ -25817,7 +25817,7 @@ To facilitate this shift, MakeProfiles h
0766af6e 1280
c34b9402
JB
1281
1282
0766af6e
JB
1283-@node Profile magnitude, Invoking astmkprof, If convolving afterwards, MakeProfiles
1284+@node Profile magnitude, astmkprof, If convolving afterwards, MakeProfiles
c34b9402
JB
1285 @subsection Profile magnitude
1286
1287 @cindex Brightness
fa459b9f 1288@@ -25843,7 +25843,7 @@ If not, only the overlapping pixels of t
c34b9402
JB
1289
1290
1291
1292-@node Invoking astmkprof, , Profile magnitude, MakeProfiles
1293+@node astmkprof, , Profile magnitude, MakeProfiles
1294 @subsection Invoking MakeProfiles
1295
1d5db55b 1296 MakeProfiles will make any number of profiles specified in a catalog either individually or in one image.
fa459b9f 1297@@ -25928,7 +25928,7 @@ Please see @ref{Sufi simulates a detecti
c34b9402
JB
1298 * MakeProfiles log file:: A description of the optional log file.
1299 @end menu
1300
1301-@node MakeProfiles catalog, MakeProfiles profile settings, Invoking astmkprof, Invoking astmkprof
1302+@node MakeProfiles catalog, MakeProfiles profile settings, astmkprof, astmkprof
1303 @subsubsection MakeProfiles catalog
1d5db55b
JB
1304 The catalog containing information about each profile can be in the FITS ASCII, FITS binary, or plain text formats (see @ref{Tables}).
1305 The latter can also be provided using standard input (see @ref{Standard input}).
fa459b9f 1306@@ -26068,7 +26068,7 @@ If @option{--tunitinp} is given, this va
c34b9402
JB
1307
1308 @end table
1309
1310-@node MakeProfiles profile settings, MakeProfiles output dataset, MakeProfiles catalog, Invoking astmkprof
1311+@node MakeProfiles profile settings, MakeProfiles output dataset, MakeProfiles catalog, astmkprof
1312 @subsubsection MakeProfiles profile settings
1313
1d5db55b 1314 The profile parameters that differ between each created profile are specified through the columns in the input catalog and described in @ref{MakeProfiles catalog}.
fa459b9f 1315@@ -26278,7 +26278,7 @@ Because the maximum operator is independ
c34b9402
JB
1316
1317 @end table
1318
1319-@node MakeProfiles output dataset, MakeProfiles log file, MakeProfiles profile settings, Invoking astmkprof
1320+@node MakeProfiles output dataset, MakeProfiles log file, MakeProfiles profile settings, astmkprof
1321 @subsubsection MakeProfiles output dataset
fa459b9f 1322 MakeProfiles takes an input catalog uses basic properties that are defined there to build a dataset, for example, a 2D image containing the profiles in the catalog.
1d5db55b 1323 In @ref{MakeProfiles catalog} and @ref{MakeProfiles profile settings}, the catalog and profile settings were discussed.
fa459b9f 1324@@ -26456,7 +26456,7 @@ MakeProfiles will not complain if you us
c34b9402
JB
1325
1326 @end table
1327
1328-@node MakeProfiles log file, , MakeProfiles output dataset, Invoking astmkprof
1329+@node MakeProfiles log file, , MakeProfiles output dataset, astmkprof
1330 @subsubsection MakeProfiles log file
1331
1d5db55b 1332 Besides the final merged dataset of all the profiles, or the individual datasets (see @ref{MakeProfiles output dataset}), if the @option{--log} option is called MakeProfiles will also create a log file in the current directory (where you run MockProfiles).
fa459b9f 1333@@ -26499,16 +26499,16 @@ If an individual image was created, this
1d5db55b 1334 @cindex Noise
fa459b9f 1335 Real data are always buried in noise, therefore to finalize a simulation of real data (for example, to test our observational algorithms) it is essential to add noise to the mock profiles created with MakeProfiles, see @ref{MakeProfiles}.
1d5db55b
JB
1336 Below, the general principles and concepts to help understand how noise is quantified is discussed.
1337-MakeNoise options and argument are then discussed in @ref{Invoking astmknoise}.
1338+MakeNoise options and argument are then discussed in @ref{astmknoise}.
c34b9402
JB
1339
1340 @menu
1341 * Noise basics:: Noise concepts and definitions.
1342-* Invoking astmknoise:: Options and arguments to MakeNoise.
1343+* astmknoise:: Options and arguments to MakeNoise.
1344 @end menu
1345
1346
1347
1348-@node Noise basics, Invoking astmknoise, MakeNoise, MakeNoise
1349+@node Noise basics, astmknoise, MakeNoise, MakeNoise
1350 @subsection Noise basics
1351
1352 @cindex Noise
fa459b9f 1353@@ -26730,7 +26730,7 @@ In the example above, did you notice how
0766af6e 1354 However, if @option{--envseed} was given, both printed seeds would be the same.
c34b9402
JB
1355
1356
1357-@node Invoking astmknoise, , Noise basics, MakeNoise
1358+@node astmknoise, , Noise basics, MakeNoise
1359 @subsection Invoking MakeNoise
1360
1d5db55b 1361 MakeNoise will add noise to an existing image.
fa459b9f 1362@@ -26848,7 +26848,7 @@ Even higher-level analysis is still need
1d5db55b
JB
1363
1364 To derive higher-level information regarding our sources in extra-galactic astronomy, cosmological calculations are necessary.
1365 In Gnuastro, CosmicCalculator is in charge of such calculations.
1366-Before discussing how CosmicCalculator is called and operates (in @ref{Invoking astcosmiccal}), it is important to provide a rough but mostly self sufficient review of the basics and the equations used in the analysis.
1367+Before discussing how CosmicCalculator is called and operates (in @ref{astcosmiccal}), it is important to provide a rough but mostly self sufficient review of the basics and the equations used in the analysis.
1368 In @ref{Distance on a 2D curved space} the basic idea of understanding distances in a curved and expanding 2D universe (which we can visualize) are reviewed.
1369 Having solidified the concepts there, in @ref{Extending distance concepts to 3D}, the formalism is extended to the 3D universe we are trying to study in our research.
1370
fa459b9f 1371@@ -26858,7 +26858,7 @@ There are many books thoroughly deriving
c34b9402
JB
1372 @menu
1373 * Distance on a 2D curved space:: Distances in 2D for simplicity
1374 * Extending distance concepts to 3D:: Going to 3D (our real universe).
1375-* Invoking astcosmiccal:: How to run CosmicCalculator
1376+* astcosmiccal:: How to run CosmicCalculator
1377 @end menu
1378
1379 @node Distance on a 2D curved space, Extending distance concepts to 3D, CosmicCalculator, CosmicCalculator
fa459b9f 1380@@ -27005,7 +27005,7 @@ We can thus parameterize the change in d
c34b9402
JB
1381 @dispmath{ds^2=c^2dt^2-a^2(t)ds_s^2 = c^2dt^2-a^2(t)(d\chi^2+r^2d\phi^2).}
1382
1383
1384-@node Extending distance concepts to 3D, Invoking astcosmiccal, Distance on a 2D curved space, CosmicCalculator
1385+@node Extending distance concepts to 3D, astcosmiccal, Distance on a 2D curved space, CosmicCalculator
1386 @subsection Extending distance concepts to 3D
1387
1d5db55b 1388 The concepts of @ref{Distance on a 2D curved space} are here extended to a 3D space that @emph{might} be curved.
fa459b9f 1389@@ -27054,7 +27054,7 @@ In a non-static universe (with a scale f
c34b9402
JB
1390
1391
1392
1393-@node Invoking astcosmiccal, , Extending distance concepts to 3D, CosmicCalculator
1394+@node astcosmiccal, , Extending distance concepts to 3D, CosmicCalculator
1395 @subsection Invoking CosmicCalculator
1396
1d5db55b 1397 CosmicCalculator will calculate cosmological variables based on the input parameters.
fa459b9f 1398@@ -27112,7 +27112,7 @@ CosmicCalculator also has features to he
37c4cc17 1399 * CosmicCalculator spectral line calculations:: How they get affected by redshift.
c34b9402
JB
1400 @end menu
1401
37c4cc17
JB
1402-@node CosmicCalculator input options, CosmicCalculator basic cosmology calculations, Invoking astcosmiccal, Invoking astcosmiccal
1403+@node CosmicCalculator input options, CosmicCalculator basic cosmology calculations, astcosmiccal, astcosmiccal
c34b9402
JB
1404 @subsubsection CosmicCalculator input options
1405
1406 The inputs to CosmicCalculator can be specified with the following options:
fa459b9f 1407@@ -27330,9 +27330,9 @@ You can get this list on the command-lin
c34b9402
JB
1408
1409
1410
37c4cc17
JB
1411-@node CosmicCalculator basic cosmology calculations, CosmicCalculator spectral line calculations, CosmicCalculator input options, Invoking astcosmiccal
1412+@node CosmicCalculator basic cosmology calculations, CosmicCalculator spectral line calculations, CosmicCalculator input options, astcosmiccal
1413 @subsubsection CosmicCalculator basic cosmology calculations
1d5db55b
JB
1414-By default, when no specific calculations are requested, CosmicCalculator will print a complete set of all its calculators (one line for each calculation, see @ref{Invoking astcosmiccal}).
1415+By default, when no specific calculations are requested, CosmicCalculator will print a complete set of all its calculators (one line for each calculation, see @ref{astcosmiccal}).
fa459b9f
JB
1416 The full list of calculations can be useful when you do not want any specific value, but just a general view.
1417 In other contexts (for example, in a batch script or during a discussion), you know exactly what you want and do not want to be distracted by all the extra information.
1d5db55b 1418
fa459b9f 1419@@ -27447,7 +27447,7 @@ The comoving volume in Megaparsecs cube
37c4cc17
JB
1420
1421
1422
1423-@node CosmicCalculator spectral line calculations, , CosmicCalculator basic cosmology calculations, Invoking astcosmiccal
1424+@node CosmicCalculator spectral line calculations, , CosmicCalculator basic cosmology calculations, astcosmiccal
1425 @subsubsection CosmicCalculator spectral line calculations
1426
1427 @cindex Rest frame wavelength
fa459b9f 1428@@ -27638,10 +27638,10 @@ But we will leave the implementation of
0766af6e
JB
1429 @end itemize
1430
1431 @menu
1432-* Invoking astscript-sort-by-night:: Inputs and outputs to this script.
1433+* astscript-sort-by-night:: Inputs and outputs to this script.
1434 @end menu
1435
1436-@node Invoking astscript-sort-by-night, , Sort FITS files by night, Sort FITS files by night
1437+@node astscript-sort-by-night, , Sort FITS files by night, Sort FITS files by night
1438 @subsection Invoking astscript-sort-by-night
1439
1440 This installed script will read a FITS date formatted value from the given keyword, and classify the input FITS files into individual nights.
fa459b9f 1441@@ -27793,10 +27793,10 @@ Gnuastro's @file{astscript-radial-profil
0766af6e
JB
1442 This script uses @ref{MakeProfiles} to generate elliptical apertures with the values equal to the distance from the center of the object and @ref{MakeCatalog} for measuring the values over the apertures.
1443
1444 @menu
1445-* Invoking astscript-radial-profile:: How to call astscript-radial-profile
1446+* astscript-radial-profile:: How to call astscript-radial-profile
1447 @end menu
1448
1449-@node Invoking astscript-radial-profile, , Generate radial profile, Generate radial profile
1450+@node astscript-radial-profile, , Generate radial profile, Generate radial profile
1451 @subsection Invoking astscript-radial-profile
1452
1453 This installed script will measure the radial profile of an object within an image.
fa459b9f
JB
1454@@ -28003,7 +28003,7 @@ This is necessary when you request measu
1455 @itemx --zeroisnotblank
1456 Account for zero-valued pixels in the profile.
1457 By default, such pixels are not considered (when this script crops the necessary region of the image before generating the profile).
1458-The long format of this option is identical to a similarly named option in Crop (see @ref{Invoking astcrop}).
1459+The long format of this option is identical to a similarly named option in Crop (see @ref{astcrop}).
1460 When this option is called, it is passed directly to Crop, therefore the zero-valued pixels are not considered as blank and used in the profile creation.
1461
1462 @item -v INT
1463@@ -28075,10 +28075,10 @@ In this section we describe a simple ins
0766af6e
JB
1464 SAO DS9@footnote{@url{http://ds9.si.edu}} is one of the most common FITS image visualization tools in astronomy and is free software.
1465
1466 @menu
1467-* Invoking astscript-ds9-region:: How to call astscript-ds9-region
1468+* astscript-ds9-region:: How to call astscript-ds9-region
1469 @end menu
1470
1471-@node Invoking astscript-ds9-region, , SAO DS9 region files from table, SAO DS9 region files from table
1472+@node astscript-ds9-region, , SAO DS9 region files from table, SAO DS9 region files from table
1473 @subsection Invoking astscript-ds9-region
1474
1475 This installed script will read two positional columns within an input table and generate an SAO DS9 region file to visualize the position of the given objects over an image.
fa459b9f 1476@@ -28239,13 +28239,13 @@ If @file{foo.fits} only consists of one
f89484e7
JB
1477
1478 On the other hand, for visualizing the contents of tables (that are also commonly stored in the FITS format), you need to call a different software (most commonly, people use TOPCAT, see @ref{TOPCAT}).
1479 And to make things more inconvenient, by default both of these are only installed as command-line software, so while you are navigating in your GUI, you need to open a terminal there, and run these commands.
1480-All of the issues above are the founding purpose of the installed script that is introduced in @ref{Invoking astscript-fits-view}.
1481+All of the issues above are the founding purpose of the installed script that is introduced in @ref{astscript-fits-view}.
1482
1483 @menu
1484-* Invoking astscript-fits-view:: How to call this script
1485+* astscript-fits-view:: How to call this script
1486 @end menu
1487
1488-@node Invoking astscript-fits-view, , Viewing FITS file contents with DS9 or TOPCAT, Viewing FITS file contents with DS9 or TOPCAT
1489+@node astscript-fits-view, , Viewing FITS file contents with DS9 or TOPCAT, Viewing FITS file contents with DS9 or TOPCAT
1490 @subsection Invoking astscript-fits-view
1491
1492 Given any number of FITS files, this script will either open SAO DS9 (for images or cubes) or TOPCAT (for tables) to visualize their contents in a graphic user interface (GUI).
fa459b9f 1493@@ -28378,14 +28378,14 @@ The tutorial uses a real dataset and inc
f89484e7
JB
1494
1495 @menu
1496 * Overview of the PSF scripts:: Summary of concepts and methods
1497-* Invoking astscript-psf-select-stars:: Select good starts within an image.
1498-* Invoking astscript-psf-stamp:: Make a stamp of each star to stack.
1499-* Invoking astscript-psf-unite:: Merge stacks of different regions of PSF.
1500-* Invoking astscript-psf-scale-factor:: Calculate factor to scale PSF to star.
1501-* Invoking astscript-psf-subtract:: Put the PSF in the image to subtract.
1502+* astscript-psf-select-stars:: Select good starts within an image.
1503+* astscript-psf-stamp:: Make a stamp of each star to stack.
1504+* astscript-psf-unite:: Merge stacks of different regions of PSF.
1505+* astscript-psf-scale-factor:: Calculate factor to scale PSF to star.
1506+* astscript-psf-subtract:: Put the PSF in the image to subtract.
1507 @end menu
1508
1509-@node Overview of the PSF scripts, Invoking astscript-psf-select-stars, PSF construction and subtraction, PSF construction and subtraction
1510+@node Overview of the PSF scripts, astscript-psf-select-stars, PSF construction and subtraction, PSF construction and subtraction
1511 @subsection Overview of the PSF scripts
1512
1513 To obtain an extended and non-parametric PSF, several steps are necessary and we will go through them here.
fa459b9f
JB
1514@@ -28413,11 +28413,11 @@ But you cannot blindly use all the stars
1515 for example, we do not want contamination from other bright, and nearby objects.
f89484e7 1516 The first script below is therefore designed for selecting only good star candidates in your image.
fa459b9f 1517 It will use different criteria, for example, good parallax (where available, to avoid confusion with galaxies), not being near to bright stars, axis ratio, etc.
f89484e7
JB
1518-For more on this script, see @ref{Invoking astscript-psf-select-stars}.
1519+For more on this script, see @ref{astscript-psf-select-stars}.
1520
1521 Once the catalog of stars is constructed, another script is in charge of making appropriate stamps of the stars.
1522 Each stamp is a cropped image of the star with the desired size, normalization of the flux, and mask of the contaminant objects.
1523-For more on this script, see @ref{Invoking astscript-psf-stamp}
1524+For more on this script, see @ref{astscript-psf-stamp}
fa459b9f 1525 After obtaining a set of star stamps, they can be stacked for obtaining the combined PSF from many stars (for example, with @ref{Stacking operators}).
f89484e7
JB
1526
1527 In the combined PSF, the masked background objects of each star's image will be covered and the signal-to-noise ratio will increase, giving a very nice view of the ``clean'' PSF.
fa459b9f 1528@@ -28433,16 +28433,16 @@ But in the example dataset from the tuto
f89484e7
JB
1529
1530 Once clean stacks of different parts of the PSF have been constructed through the steps above, it is therefore necessary to blend them all into one.
1531 This is done by finding a common radial region in both, and scaling the inner region by a factor to add with the outer region.
1532-This is not trivial, therefore, a third script is in charge of it, see @ref{Invoking astscript-psf-unite}.
1533+This is not trivial, therefore, a third script is in charge of it, see @ref{astscript-psf-unite}.
1534
1535 Having constructed the PSF as described above (or by any other procedure), it can be scaled to the brightness of the various stars in the image to get subtracted (and thus remove the extended/bright wings; better showing the background objects of interest).
1536 Note that the absolute flux of a PSF is meaningless (and in fact, it is usually normalized to have a total sum of unity!), so it should be scaled.
1537 We therefore have another script that will calculate the scale (multiplication) factor of the PSF for each star.
1538-For more on the scaling script, see @ref{Invoking astscript-psf-scale-factor}.
1539+For more on the scaling script, see @ref{astscript-psf-scale-factor}.
1540
1541 Once the flux factor has been computed, a final script is in charge of placing the scaled PSF over the proper location in the image, and subtracting it.
1542 It is also possible to only obtain the modeled star by the PSF.
1543-For more on the scaling and positioning script, see @ref{Invoking astscript-psf-subtract}.
1544+For more on the scaling and positioning script, see @ref{astscript-psf-subtract}.
1545
1546 As mentioned above, in the following sections, each script has its own documentation and list of options for very detailed customization (if necessary).
1547 But if you are new to these scripts, before continuing, we recommend that you do the tutorial @ref{Building the extended PSF}.
fa459b9f 1548@@ -28452,7 +28452,7 @@ Just do not forget to run every command,
f89484e7
JB
1549
1550
1551
1552-@node Invoking astscript-psf-select-stars, Invoking astscript-psf-stamp, Overview of the PSF scripts, PSF construction and subtraction
1553+@node astscript-psf-select-stars, astscript-psf-stamp, Overview of the PSF scripts, PSF construction and subtraction
1554 @subsection Invoking astscript-psf-select-stars
1555 This installed script will select good star candidates for constructing a PSF.
1556 It will consider stars within a given range of brightness without nearby contaminant objects.
fa459b9f 1557@@ -28608,7 +28608,7 @@ The output name of the final catalog con
f89484e7
JB
1558
1559
1560
1561-@node Invoking astscript-psf-stamp, Invoking astscript-psf-unite, Invoking astscript-psf-select-stars, PSF construction and subtraction
1562+@node astscript-psf-stamp, astscript-psf-unite, astscript-psf-select-stars, PSF construction and subtraction
1563 @subsection Invoking astscript-psf-stamp
fa459b9f 1564 This installed script will generate a stamp of fixed size, centered at the provided coordinates (performing sub-pixel re-gridding if necessary) and normalized at a certain normalization radius.
f89484e7 1565 Optionally, it will also mask all the other background sources.
fa459b9f 1566@@ -28793,7 +28793,7 @@ The main reason of setting this name is
f89484e7
JB
1567
1568
1569
1570-@node Invoking astscript-psf-unite, Invoking astscript-psf-scale-factor, Invoking astscript-psf-stamp, PSF construction and subtraction
1571+@node astscript-psf-unite, astscript-psf-scale-factor, astscript-psf-stamp, PSF construction and subtraction
1572 @subsection Invoking astscript-psf-unite
1573 This installed script will join two PSF images at a given radius.
1574 This operation is commonly used when merging (uniting) the inner and outer parts of the PSF.
fa459b9f 1575@@ -28853,7 +28853,7 @@ The HDU/extension of the inner PSF (opti
f89484e7
JB
1576 @itemx --scale=FLT
1577 Factor by which the inner part (@option{--inner}) is multiplied.
1578 This factor is necessary to put the two different parts of the PSF at the same flux level.
1579-A convenient way of obtaining this value is by using the script @file{astscript-model-scale-factor}, see @ref{Invoking astscript-psf-scale-factor}.
1580+A convenient way of obtaining this value is by using the script @file{astscript-model-scale-factor}, see @ref{astscript-psf-scale-factor}.
1581 There is also a full tutorial on using all the @command{astscript-psf-*} installed scripts together, see @ref{Building the extended PSF}.
1582 We recommend doing that tutorial before starting to work on your own datasets.
1583
fa459b9f 1584@@ -28900,7 +28900,7 @@ This option is useful for debugging and
f89484e7
JB
1585
1586
1587
1588-@node Invoking astscript-psf-scale-factor, Invoking astscript-psf-subtract, Invoking astscript-psf-unite, PSF construction and subtraction
1589+@node astscript-psf-scale-factor, astscript-psf-subtract, astscript-psf-unite, PSF construction and subtraction
1590 @subsection Invoking astscript-psf-scale-factor
1591 This installed script will compute the multiplicative factor (scale) that is necessary to match the PSF to a given star.
1592 The match in flux is done within a ring of pixels.
fa459b9f 1593@@ -28947,9 +28947,9 @@ To fully understand the process on first
f89484e7
JB
1594 The most common use-cases of this scale factor are:
1595 @enumerate
1596 @item
1597-To find the factor for joining two different parts of the same PSF, see @ref{Invoking astscript-psf-unite}.
1598+To find the factor for joining two different parts of the same PSF, see @ref{astscript-psf-unite}.
1599 @item
1600-When modeling a star in order to subtract it using the PSF, see @ref{Invoking astscript-psf-subtract}.
1601+When modeling a star in order to subtract it using the PSF, see @ref{astscript-psf-subtract}.
1602 @end enumerate
1603
1604 For a full tutorial on how to use this script along with the other @command{astscript-psf-*} scripts in Gnuastro, please see @ref{Building the extended PSF}.
fa459b9f 1605@@ -29030,7 +29030,7 @@ This option is useful for debugging and
f89484e7
JB
1606
1607
1608
1609-@node Invoking astscript-psf-subtract, , Invoking astscript-psf-scale-factor, PSF construction and subtraction
1610+@node astscript-psf-subtract, , astscript-psf-scale-factor, PSF construction and subtraction
1611 @subsection Invoking astscript-psf-subtract
1612 This installed script will put the provided PSF into a given position within the input image (implementing sub-pixel adjustments where necessary), and then it will subtract it.
1613 It is aimed at modeling and subtracting the scattered light field of an input image.
fa459b9f 1614@@ -29114,7 +29114,7 @@ If the central position does not fall in
f89484e7
JB
1615 @itemx --scale=FLT
1616 Factor by which the PSF (@option{--psf}) is multiplied.
1617 This factor is necessary to put the PSF with the desired flux level.
1618-A convenient way of obtaining this value is by using the script @file{astscript-scale-factor}, see @ref{Invoking astscript-psf-scale-factor}.
1619+A convenient way of obtaining this value is by using the script @file{astscript-scale-factor}, see @ref{astscript-psf-scale-factor}.
1620 For a full tutorial on using the @command{astscript-psf-*} scripts together, see @ref{Building the extended PSF}.
1621
1622 @item -t
fa459b9f 1623@@ -29759,10 +29759,10 @@ Please see @ref{Optional dependencies} f
c34b9402
JB
1624 @end cartouche
1625
1626 @menu
1627-* Invoking astbuildprog:: Options and examples for using this program.
1628+* astbuildprog:: Options and examples for using this program.
1629 @end menu
1630
1631-@node Invoking astbuildprog, , BuildProgram, BuildProgram
1632+@node astbuildprog, , BuildProgram, BuildProgram
1633 @subsection Invoking BuildProgram
1634
1d5db55b 1635 BuildProgram will compile and link a C source program with Gnuastro's library and all its dependencies, greatly facilitating the compilation and running of small programs that use Gnuastro's library.
fa459b9f
JB
1636@@ -37430,7 +37430,7 @@ The @code{warp} library functions are @e
1637 Acceptable fraction of output pixel that is covered by input pixels.
1638 The value should be between 0 and 1 (inclusive).
1639 If the area of an output pixel is covered by less than this fraction, its value will be @code{NaN}.
1640-For more, see the description of @option{--coveredfrac} in @ref{Invoking astwarp}.
1641+For more, see the description of @option{--coveredfrac} in @ref{astwarp}.
1642
1643 @item size_t edgesampling
1644 Set the number of extra vertices along each edge of the output pixel's polygon to account for potential curvature due to projection or distortion.
1645@@ -38442,7 +38442,7 @@ main(void)
1646 @subsection Library demo - Warp to another image
1647 Gnuastro's warp library (that you can access by including @file{gnuastro/warp.h}) allows you to resample an image from a grid to another entirely using the WCSLIB (while accounting for distortions if necessary; see @ref{Warp library}).
1648 The Warp library uses a pixel-mixing or area-based resampling approach which is fully described in @ref{Resampling}.
1649-The most generic uses cases for this library are already available in the @ref{Invoking astwarp} program.
1650+The most generic uses cases for this library are already available in the @ref{astwarp} program.
1651 For a related demo (where the output grid and WCS are constructed from scratch), see @ref{Library demo - Warp to new grid}.
1652
1653 In the example below, we are warping the @code{input.fits} file to the same pixel grid and WCS as @code{reference.fits} image (assuming it is in hdu @code{0}).
1654@@ -38537,7 +38537,7 @@ main(void)
1655 @subsection Library demo - Warp to new grid
1656 Gnuastro's warp library (that you can access by including @file{gnuastro/warp.h}) allows you to resample an image from a grid to another entirely using the WCSLIB (while accounting for distortions if necessary; see @ref{Warp library}).
1657 The Warp library uses a pixel-mixing or area-based resampling approach which is fully described in @ref{Resampling}.
1658-The most generic uses cases for this library are already available in the @ref{Invoking astwarp} program.
1659+The most generic uses cases for this library are already available in the @ref{astwarp} program.
1660 For a related demo (where the output grid and WCS are imported from another file), see @ref{Library demo - Warp to another image}.
1661
1662 In the example below, we'll assume you have the SDSS image downloaded in @ref{Downloading and validating input data}.
1663@@ -39509,7 +39509,7 @@ philosophy}.
1d5db55b
JB
1664
1665 As you have already noticed for every program/library, it is very important
1666 that the basics of the science and technique be explained in separate
1667-subsections prior to the `Invoking Programname' subsection. If you are
1668+subsections prior to the `Programname' subsection. If you are
1669 writing a new program or your addition to an existing program involves a
1670 new concept, also include such subsections and explain the concepts so a
1671 person completely unfamiliar with the concepts can get a general initial
fa459b9f 1672@@ -39527,7 +39527,7 @@ after reading a long text, nothing else.
1d5db55b
JB
1673 relevant/interesting for the reader, there is no page number limit/cost.
1674
1675 It might also help if you start discussing the usage of your idea in the
1676-`Invoking ProgramName' subsection (explaining the options and arguments you
1677+`ProgramName' subsection (explaining the options and arguments you
1678 have in mind) at this stage too. Actually starting to write it here will
1679 really help you later when you are coding.
1680
fa459b9f 1681@@ -40629,22 +40629,22 @@ The following scripts are used to estima
f89484e7
JB
1682
1683 @table @code
1684 @item astscript-psf-select-stars
1685-(see @ref{Invoking astscript-psf-select-stars}) Find all the stars within an image that are suitable for constructing an extended PSF.
1686+(see @ref{astscript-psf-select-stars}) Find all the stars within an image that are suitable for constructing an extended PSF.
1687 If the image has WCS, this script can automatically query Gaia to find the good stars.
1688
1689 @item astscript-psf-stamp
1690-(see @ref{Invoking astscript-psf-stamp}) build a crop (stamp) of a certain width around a star at a certain coordinate in a larger image.
1691+(see @ref{astscript-psf-stamp}) build a crop (stamp) of a certain width around a star at a certain coordinate in a larger image.
1692 This script will do sub-pixel re-positioning to make sure the star is centered and can optionally mask all other background sources).
1693
1694 @item astscript-psf-scale-factor
1695-(see @ref{Invoking astscript-psf-scale-factor}) Given a PSF model, and the central coordinates of a star in an image, find the scale factor that has to be multiplied by the PSF to scale it to that star.
1696+(see @ref{astscript-psf-scale-factor}) Given a PSF model, and the central coordinates of a star in an image, find the scale factor that has to be multiplied by the PSF to scale it to that star.
1697
1698 @item astscript-psf-unite
1699-(see @ref{Invoking astscript-psf-unite}) Unite the various components of a PSF into one.
1700+(see @ref{astscript-psf-unite}) Unite the various components of a PSF into one.
fa459b9f 1701 Because of saturation and non-linearity, to get a good estimate of the extended PSF, it is necessary to construct various parts from different magnitude ranges.
f89484e7
JB
1702
1703 @item astscript-psf-subtract
1704-(see @ref{Invoking astscript-psf-subtract}) Given the model of a PSF and the central coordinates of a star in the image, do sub-pixel re-positioning of the PSF, scale it to the star and subtract it from the image.
1705+(see @ref{astscript-psf-subtract}) Given the model of a PSF and the central coordinates of a star in the image, do sub-pixel re-positioning of the PSF, scale it to the star and subtract it from the image.
1706 @end table
1707
1708 @end table
This page took 0.437546 seconds and 4 git commands to generate.