[gnuastro-commits] master 4aa8ec9: New scale option of ImageWarp used in tutorial

[Mohammad Akhlaghi]

branch: master
commit 4aa8ec96cb6e8953d6801158e7dfd52f2e91caef
Author: Mohammad Akhlaghi <address@hidden>
Commit: Mohammad Akhlaghi <address@hidden>

    New scale option of ImageWarp used in tutorial
    
    With the new `--scale' option of ImageWarp, it was no longer necessary to
    confuse the new user with the warping matrix in the tutorial. So it was
    used and the previous discussion on the FITS coordinates were removed.
    
    Some typos that were found after the 0.2.28 release were also corrected.
---
 NEWS              |    3 +--
 doc/gnuastro.texi |   43 ++++++++++++++++++++-----------------------
 2 files changed, 21 insertions(+), 25 deletions(-)

diff --git a/NEWS b/NEWS
index c3f2349..32f070b 100644
--- a/NEWS
+++ b/NEWS
@@ -1,6 +1,6 @@
 GNU Astronomy Utilities NEWS                          -*- outline -*-
 
-* Noteworthy changes in release 0.2-28 (library 1.0.0) (2016-10-23) [alpha]
+* Noteworthy changes in release 0.2.28 (library 1.0.0) (2016-10-23) [alpha]
 
 ** Bug fixes
 
@@ -43,7 +43,6 @@ GNU Astronomy Utilities NEWS                          -*- 
outline -*-
   `GAL_GNUASTRO_HAVE_LIBGIT2'
     Has a value of 1 if the host system has the Git library (`libgit2').
 
-
 ** Removed programs, functions, macros
 
   `gal_wcs_angular_distance'
diff --git a/doc/gnuastro.texi b/doc/gnuastro.texi
index 80f40fd..979f7d1 100644
--- a/doc/gnuastro.texi
+++ b/doc/gnuastro.texi
@@ -2006,23 +2006,25 @@ $ls
 @end example
 
 @noindent
-When convolution finished, Sufi opened the @file{cat_convolved.fits}
-file and showed the effect of convolution to his student and explained
-to him how a PSF with a larger FWHM would make the points even
-wider. With the convolved image ready, they were ready to re-sample it
-to the original pixel scale Sufi had planned. Sufi explained the basic
-concepts of warping the image to his student and also the fact that
-since the center of a pixel is assumed to take integer values in the
-FITS standard, the transformation matrix would not be a simple scaling
-but would also need translating, see @ref{Merging multiple
-warpings}. Then he ran ImageWarp with the following command:
+When convolution finished, Sufi opened the @file{cat_convolved.fits} file
+and showed the effect of convolution to his student and explained to him
+how a PSF with a larger FWHM would make the points even wider. With the
+convolved image ready, they were ready to re-sample it to the original
+pixel scale Sufi had planned. Sufi explained the basic concepts of warping
+the image to his student and ran ImageWarp with the following command:
 
 @example
-$ astimgwarp cat_convolved.fits --matrix="0.2,0,0.4  0,0.2,0.4  0,0,1"
+$ astimgwarp cat_convolved.fits --scale=0.2
 ImageWarp started on Mon Apr  6 16:51:59 953
+ Using 8 CPU threads.
+ Input image: cat_convolved.fits
+ matrix:
+        0.2000   0.0000   0.4000
+        0.0000   0.2000   0.4000
+        0.0000   0.0000   1.0000
 ImageWarp finished in:  0.481421 (seconds)
 $ ls
-0_cat.fits        cat_convolved.fits         cat.fits
+0_cat.fits     cat_convolved.fits         cat.fits
 astmkprof.log  cat_convolved_warped.fits  cat.txt
 @end example
 
@@ -2107,7 +2109,7 @@ rm out.fits
 astmkprof --prepforconv --naxis1=500 --naxis2=500            \
           --zeropoint=18.0 "$base".txt
 astconvolve --kernel=0.fits "$base".fits
-astimgwarp "$base"_convolved.fits --matrix="0.2,0,0.4  0,0.2,0.4  0,0,1"
+astimgwarp "$base"_convolved.fits --scale=0.2
 astimgcrop "$base"_convolved_warped.fits                     \
            --section=$edge:*-$edge,$edge:*-$edge
 astmknoise --zeropoint=18 --background=7 --output=out.fits   \
@@ -5324,7 +5326,8 @@ reproduce that same result later, even if you have made
 changes/progress. For one example of a research paper's reproduction
 pipeline, please see the
 @url{https://gitlab.com/makhlaghi/NoiseChisel-paper, reproduction pipeline}
-of @ref{NoiseChisel}.
+of the @url{https://arxiv.org/abs/1505.01664, paper} introducing
address@hidden
 
 @item CFITSIO
 The version of CFITSIO used (see @ref{CFITSIO}).
@@ -9323,12 +9326,6 @@ first will be used for the first axis and the second 
will be used for the
 second axis. If you only need projection along one axis, use @option{0} for
 the axis you don't need.
 
address@hidden table
-
-
-ImageWarp also provides the following options:
address@hidden @option
-
 @item -m
 @itemx --matrix
 (@option{=STR}) The warp/transformation matrix. All the elements in this
@@ -9343,7 +9340,7 @@ The transformation matrix can be either 2 by 2 or 3 by 3 
array. In the
 former case (if a 2 by 2 matrix is given), then it is converted to a 3 by 3
 matrix with two translation terms added to correct for the FITS definition
 of position (see @ref{Warping basics}, @ref{Merging multiple warpings}, and
-the box above for more).
+the explanations above for more).
 
 @cindex NaN
 The determinant of the matrix has to be non-zero and it must not
@@ -9352,9 +9349,9 @@ elements of the matrix have to be written row by row. So 
for the
 general homography matrix of @ref{Warping basics}, it should be called
 with @command{--matrix=a,b,c,d,e,f,g,h,1}.
 
address@hidden nofitscorrect
address@hidden --nofitscorrect
 Do not correct for the FITS definition of the pixel center as described in
-the @option{--matrix} option.
+the descriptions above.
 
 @item --hstartwcs
 (@option{=INT}) Specify the first header keyword number (line) that