[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[gnuastro-commits] master 0c52cb6 3/3: NEWS file and webpage updated for
|
From: |
Mohammad Akhlaghi |
|
Subject: |
[gnuastro-commits] master 0c52cb6 3/3: NEWS file and webpage updated for 0.3 release |
|
Date: |
Thu, 1 Jun 2017 13:28:06 -0400 (EDT) |
branch: master
commit 0c52cb684e2726900eb85ca5bae43b3adbd93ac3
Author: Mohammad Akhlaghi <address@hidden>
Commit: Mohammad Akhlaghi <address@hidden>
NEWS file and webpage updated for 0.3 release
For the 0.3 release, all the recent changes have been incorporated into the
NEWS file. For the new and changed features of the programs, issues related
to one program now start with that program's name followed by a colon. So
if the users can more easily find changes. All the issues are also sorted
by program name.
In the webpage, a new "Installation" title was added which now gives a fast
description of how to install Gnuastro and its mandatory dependencies.
---
NEWS | 240 ++++++++++++++++++++++++++++----------------------
doc/gnuastro-top.html | 52 +++++------
2 files changed, 161 insertions(+), 131 deletions(-)
diff --git a/NEWS b/NEWS
index 9441445..f231f95 100644
--- a/NEWS
+++ b/NEWS
@@ -1,6 +1,6 @@
GNU Astronomy Utilities NEWS -*- outline -*-
-* Noteworthy changes in release 0.2.206 (library 1.0.0) (2017-05-05) [alpha]
+* Noteworthy changes in release 0.3 (library 1.0.0) (2017-06-01) [stable]
This is a full re-write of Gnuastro. Most importantly, Gnuastro now has a
new generic data contaihtner (`gal_data_t'). This new container can now
@@ -62,14 +62,13 @@ GNU Astronomy Utilities NEWS -*-
outline -*-
"Output headers" section of the book for a discussion on the usefulness
of this new feature.
- Gnuastro now has a new program called "BuildProgram" to easily compile,
- link and run a C program you have written with Gnuastro's libraries
- without having to worry about which libraries (Gnuastro dependencies)
- your program needs. For example if your C source code is called
- `myprog.c', you can compile, link and run it with this simple command and
- let GNU Libtool worry about the linking.
-
- $ astbuildprog myprog.c
+ BuildProgram: a new program to easily compile, link and run a C program
+ you have written with Gnuastro's libraries without having to worry about
+ which libraries (Gnuastro dependencies) your program needs. Debugging
+ (`-g'), optimizations (`-O'), warnings (`-W'), include search path
+ (`-I'), link search path (`-L'), and linked libraries (`-l') compiler
+ options are also supported. BuildProgram will greatly facilitate the easy
+ usage of Gnuastro's libraries.
** Removed programs or library features
@@ -125,90 +124,88 @@ GNU Astronomy Utilities NEWS -*-
outline -*-
Making a log file is now optional and users have to explicitly ask for it
with the `--log' option.
- Warp can now align the image with the celestial coordiates using the
- `--align' option.
-
- Warp can now warp without an input matrix, using the following options:
- `--shear', `--flip', `--project', `--rotate', `--scale',
- `--translate'. Any number of these transformations (along with the
- `--align' option) can be called at runtime and they will be applied in
- the same order to create one warping matrix. By default the FITS
- coordinates will also be corrected.
+ Slower building of Gnuastro: Binary operators (e.g., plus or multiply)
+ are now done in the native type of the input dataset. Doing so for all
+ the different combinations of types, greatly slows down the initial
+ compilation of Gnuastro (after running `make'). So for every type there
+ is now a `--enable-bin-op-*' configure time option. When the dataset's
+ type isn't compiled (only for the binary operators), it will be converted
+ to a compiled type and then converted back in the end.
- Arithmetic now does all its operations in the native data type of the
+ Arithmetic: all operations are done in the native data type of the
dataset. Until now, it would convert the data internally to double
precision floating point, do the requested operation and write the data
back in the proper type. So this new implementation is much more
- efficient than the 0.2 version.
+ efficient.
- Arithmetic now accepts two new classes of operators: type conversion
- operators to all standard types and integer-only operators (all C
- bit-wise operators and the modulo operator).
+ Arithmetic: two new classes of operators: type conversion operators to
+ all standard types and integer-only operators (all C bit-wise operators
+ and the modulo operator).
- Arithmetic does the binary operators (e.g., plus or multiply) also in the
- native type of the input dataset. Doing so for all the different
- combinations of types, greatly slows down the initial compilation of
- Gnuastro (after running `make'). So for every type there is now a
- `--enable-bin-op-*' configure time option. Only for a the binary
- operators, when the dataset's type isn't compiled, it will be converted
- to a compiled type and then converted back.
+ ConvertType: can also print the input dataset to the command-line
+ (`stdout'). To use this feature set the output filename to `stdout'.
Convolve now has the `--minsharpspec' option to specify the minimum
spectrum value to use in deconvolution (matching PSFs).
- MakeProfile can now accept the radial function of profiles as
+ Crop: when in WCS mode it can still only work on aligned images. However,
+ very small floating point errors in writing the WCS (for example 10e-13
+ degrees) are now acceptable. Until now these would cause Crop to complain
+ and abort.
+
+ Crop: the name of the crop can be pre-determined based on the values in a
+ given in a table column. This allows your object's IDs to be directly
+ used as the crop's file name for example.
+
+ MakeCatalog now also reports the surface brightness in
+ mag/arcsec^2. Until now, MakeCatalog would only print the dataset's
+ surface brightness in units of magnitudes/pixel. But that is not nicely
+ comparable to other datasets. Hence, using a simple calculation (from the
+ pixel projected size, fully derived in the book), it now also reports the
+ surface brightness in magnitudes/arcsec^2 also.
+
+ MakeProfiles: Profile codes now start from `1' (until now they started
+ from `0').
+
+ MakeProfiles: now accepts the radial function of profiles as
human-readable strings instead of a code for each profile (which was very
cryptic, although codes are also still acceptable). For example in the
- profile column you can now write `sersic' instead of the code `1'. Also
- compared to the previous versions where the codes started from `0', not
- they start from `1'.
-
- Crop can now read the name of the crop based on a value in a given in a
- table column. This allows your object's IDs to be directly used as the
- crop's file name.
+ profile column you can now write `sersic' instead of the code `1'.
- ConvertType can also print the input dataset to the command-line
- (`stdout'). To use this feature set the output filename to `stdout'.
+ NoiseChisel: the new `--cleandilated' option will remove dilated objects
+ that have a low S/N (it is mainly useful on very clean or mock images).
+ For non-clean noise, it will result in a decrease of completeness. With
+ this new option, NoiseChisel will also print detection S/N values when
+ run with the `--checkdetsn' option.
- The Statistics program can now read table columns as well as images and
- do basic operations on them. It can also only work on a certain range of
- the data. Alternatively, you can define the range on another reference
- column, but use values of the main column.
+ Statistics: now reads table columns as well as images and does basic
+ operations on them. It can also only work on a certain range of the data
+ (instead of the whole set). Alternatively, you can define the range on
+ another reference column, but use values of the main column.
- Statistics can also do all its single-valued measurements on a
+ Statistics: all its single-valued measurements can now be done on a
tessellation (tile grid) over the input dataset.
- Statistics now has features to estimate the Sky value on the image using
- the mode's quantile similar to what NoiseChisel does to find its initial
+ Statistics: can now estimate the Sky value on the input dataset using the
+ mode's quantile similar to what NoiseChisel does to find its initial
threshold.
- Statistics now has several new single valued calculations: `--quantile',
+ Statistics: has several new single valued calculations: `--quantile',
`--quantfunc' (quantile function), `--mode', `--modequant', `--modesym',
and `--modesymvalue'.
- When in WCS mode, Crop can still only work on aligned images. However,
- very small floating point errors in writing the WCS (for example 10e-13
- degrees) are now acceptable. Until now these would cause Crop to complain
- and abort.
+ Warp: align the image with the celestial coordiates using the `--align'
+ option.
- NoiseChisel now has a new `--cleandilated' option to remove dilated
- objects that have a low S/N (it is mainly useful on very clean or mock
- images), for non-clean noise, it will result in a decrease of
- completeness. With this new option, NoiseChisel will also print detection
- S/N values when run with the `--checkdetsn' option.
+ Warp: standard modular warpings can now be requested without an input
+ matrix, using the following options: `--shear', `--flip', `--project',
+ `--rotate', `--scale', `--translate'. Any number of these transformations
+ (along with the `--align' option) can be called on the command-line and
+ they will be applied in the same order to create one warping matrix. By
+ default the WCS will also be corrected.
** Changes in behavior
- When a 2 by 2 matrix is given to Warp, the FITS pixel positions (which
- define the center of a pixel as an integer) are automatically implemented
- internally, see "Invoking Warp" in the manual for more.
-
- To select column(s) by regular expression searching, the name now has to
- be put in `/ /' (similar to AWK). If a value isn't in `/ /', the programs
- will only select a column with the exact match.
-
- Crop's `--section' syntax is now inclusive in both bounds.
-
Mask image options have been removed from all programs. Instead, all
programs can work directly on data with blank values. So when some pixels
must be masked, the Arithmetic program's `where' operator can be used to
@@ -217,27 +214,77 @@ GNU Astronomy Utilities NEWS -*-
outline -*-
images. Managing all these different choices in every program would only
confuse the user (with too many options).
- Crop only checks if the center of a crop is filled when the crop was
+ Arithmetic: the `x' letter is now used to represent the multiplication
+ operator. Previously it was `*' which needed quotation and was thus very
+ inconvenient.
+
+ Convolve: the old `--frequency' and `--spatial' options have been removed
+ and are replaced by `--domain' which accepts values of `frequency' and
+ `spatial'.
+
+ Convolve: the old `--viewfreqsteps' was changed to `--checkfreqsteps' to
+ fit with the general style of such check images in all Gnuastro's
+ programs.
+
+ Crop: `--section' syntax is now inclusive in both bounds.
+
+ Crop: only checks if the center of a crop is filled when the crop was
defined by its center (for example with `--ra' and `--dec'). The verbose
outputs of Crop are also not cryptic 0s or 1s. The are human readable
text.
- Crop doesn't have the separate `--imgmode' and `--wcsmode' options any
+ Crop: doesn't have separate `--imgmode' and `--wcsmode' options any
more. There is now a single `--mode' option which accepts values of `img'
or `wcs'.
- Convolve's old `--frequency' and `--spatial' options have been removed
- and are replaced by `--domain' which accepts values of `frequency' and
- `spatial'.
+ MakeProfiles: the old `--inputascanvas' is now called `--clearcanvas'.
+
+ MakeProfiles: until now, it would abort with an error when the input
+ columns had blank values. But for masking, it might happen that you set a
+ blank magnitude. So this check has now been removed when reading the
+ magnitude column.
- Convolve's old `--viewfreqsteps' was changed to `--checkfreqsteps' to fit
- with the general style of such check images in all Gnuastro's programs.
+ NoiseChisel: default value of the `--minskyfrac' option (new name for the
+ old `--minbfrac') is now 0.7 as opposed to 0.5. This will allow much
+ better estimation of noise properties (by default). It may be slightly
+ too high for a crowded field, but the users can change it on the
+ command-line (or in a configuration file) for such datasets.
- Warp's old `--nowcscorrection' option has been given a more clear name of
- `--keepwcs'. With this option, Warp will not apply the warp the input's
- WCS structure.
+ NoiseChisel: when it is run with any of the `--check' options, it will
+ abort after all the check images have been created. This is very useful
+ for checking your parameters until each step and not be distracted (or
+ have to wait) for later steps to finish.
- Warp's old `--maxblankfrac' option has been changed to
+ Statistics: will not make a histogram and cumulative frequency files, or
+ calculate sigma-clipped results by default (with no options). It will
+ just print some basic information.
+
+ Table: Previously, if a column was requested, the `-i' option would be
+ ignored. But it often happens that the users forget a column name after
+ already typing several of their desired columns. So the opposite behavior
+ is preferred. Because when more than a couple of columns are needed, you
+ will probably forget the column identifiers of the last few and having to
+ retype everything is very frustrating. Something like how `--help' takes
+ precedence over all other options.
+
+ Table: to select column(s) by regular expression searching, the name now
+ has to be put in `/ /' (similar to AWK). If a value isn't in `/ /', the
+ programs will only select a column with the exact match.
+
+ Warp: when a 2 by 2 matrix is given, the FITS pixel positions (which
+ define the center of a pixel as an integer) are automatically implemented
+ internally, see "Invoking Warp" in the manual for more.
+
+ Warp: the old `--nofitscorrect' option has been changed to
+ `--centeroncorner' to be more clear. The new option is now more general
+ than before and also works on warping with a matrix, not just on modular
+ warpings.
+
+ Warp: the old `--nowcscorrection' option has been given a more clear name
+ of `--keepwcs'. With this option, Warp will not apply the warp the
+ input's WCS structure.
+
+ Warp: the old `--maxblankfrac' option has been changed to
`--coveredfrac'. Until now, Warp would only look for the fraction of
input blank/NaN pixel area over the output pixel. But this would be
useless on the edges of the image. So the new `--coveredfrac' option
@@ -246,33 +293,6 @@ GNU Astronomy Utilities NEWS -*-
outline -*-
this to set edge pixels that are not fully covered in the new grid to
blank and have a flat warped image.
- Warp's old `--nofitscorrect' option has been changed to
- `--centeroncorner' to be more clear. The new option is now more general
- than before and also works on warping with a matrix, not just on modular
- warpings.
-
- MakeProfiles' old `--inputascanvas' is now called `--clearcanvas'.
-
- Until now, MakeProfiles would abort with an error when the input columns
- had blank values. But for masking, it might happen that you set a blank
- magnitude. So this check has now been removed when reading the magnitude
- column.
-
- Statistics will not make a histogram and cumulative frequency files, or
- calculate sigma-clipped results by default (with no options). It will
- just print some basic information.
-
- NoiseChisel's default value of the `--minskyfrac' option (new name for
- the old `--minbfrac') is now 0.7 as opposed to 0.5. This will allow much
- better estimation of noise properties (by default). It may be slightly
- too high for a crowded field, but the users can change it on the
- command-line (or in a configuration file) for such datasets.
-
- When NoiseChisel is run with any of the `--check' options, it will abort
- after all the check images have been created. This is very useful for
- checking your parameters until each step and not be distracted (or have
- to wait) for later steps to finish.
-
** Bug fixes
Using `%zu' to print `size_t' variables for clean build on 32-bit
@@ -299,6 +319,13 @@ GNU Astronomy Utilities NEWS -*-
outline -*-
Using image naxes[n] when checkcenter is larger (bug #50099).
+ Memory leak in MakeCatalog corrected (bug #51118).
+
+ Fix copy-paste error in MakeCatalog flag arrays (bug #51130).
+
+
+
+
* Noteworthy changes in release 0.2 (library 0.0.0) (2016-10-03) [stable]
@@ -384,6 +411,9 @@ GNU Astronomy Utilities NEWS -*-
outline -*-
the configuration files.
+
+
+
* Noteworthy changes in release 0.1 (2016-05-30) [stable]
** Bug fixes
diff --git a/doc/gnuastro-top.html b/doc/gnuastro-top.html
index 23d4141..a0dded7 100644
--- a/doc/gnuastro-top.html
+++ b/doc/gnuastro-top.html
@@ -78,6 +78,7 @@ h3 { clear: both; }
<ul>
<li><a href="#introduction">Introduction</a></li>
<li><a href="#download">Download</a></li>
+ <li><a href="#installation">Installation</a></li>
<li><a href="#documentation">Book (documentation)</a></li>
<li><a href="#mail">Gnuastro mailing lists</a></li>
<li><a href="#bug">Report a Bug</a></li>
@@ -127,26 +128,20 @@ for entertaining and easy to read real world examples of
using
<p>
The current stable release
- is <a href="http://ftp.gnu.org/gnu/gnuastro/gnuastro-0.2.tar.gz";>Gnuastro
- 0.2</a> (October 3rd, 2016).
- Use <a href="http://ftpmirror.gnu.org/gnuastro/gnuastro-0.2.tar.gz";>a
+ is <a href="http://ftp.gnu.org/gnu/gnuastro/gnuastro-0.3.tar.gz";>Gnuastro
+ 0.3</a> (June 1st, 2017).
+ Use <a href="http://ftpmirror.gnu.org/gnuastro/gnuastro-0.3.tar.gz";>a
mirror</a> if possible.
<!-- Comment the test release notice when the test release is not more
recent than the stable release -->
- <br />The current Test release
- is <a
href="http://alpha.gnu.org/gnu/gnuastro/gnuastro-0.2.206-ea30.tar.gz";>Gnuastro
- 0.2.206-ea30</a> (May 5th, 2017). See
- the <a
href="http://git.savannah.gnu.org/cgit/gnuastro.git/plain/NEWS";>NEWS</a>
- file for changes.
-
<br />New releases are announced
in <a
href="https://lists.gnu.org/mailman/listinfo/info-gnuastro";>info-gnuastro</a>.
To stay up to date, please subscribe.</p>
<p>For details of the significant changes please see the
- <a
href="http://git.savannah.gnu.org/cgit/gnuastro.git/plain/NEWS?id=gnuastro_v0.2";>NEWS</a>
+ <a
href="http://git.savannah.gnu.org/cgit/gnuastro.git/plain/NEWS?id=gnuastro_v0.3";>NEWS</a>
file.</p>
<p>The
@@ -155,22 +150,6 @@ for entertaining and easy to read real world examples of
using
(<a
href="http://ftpmirror.gnu.org/gnuastro/gnuastro-latest.tar.gz";>http://ftpmirror.gnu.org/gnuastro/gnuastro-latest.tar.gz</a>)
if possible.</p>
-<p>The <a href="manual/html_node/Installation.html">Installation</a>
- chapter of the <a href="manual/">Gnuastro book</a>
- thoroughly discusses
- the <a href="manual/html_node/Dependencies.html">dependencies</a>,
- <a href="manual/html_node/Downloading-the-source.html">downloading
- methods</a>, and the
- <a href="manual/html_node/Build-and-install.html">building and
- installation</a> of Gnuastro. In short once the three mandatory
- dependencies
- (<a href="manual/html_node/CFITSIO.html">CFITSIO</a>, <a
href="manual/html_node/WCSLIB.html">WCSLIB</a>
- and <a href="manual/html_node/GNU-Scientific-Library.html">GNU Scientific
- Library</a>) are installed the
- standard <code>./configure</code>, <code>make</code>, <code>make
- check</code>, and <code>make install</code> are enough
- (see <a href="manual/html_node/Quick-start.html">Quick start</a>).</p>
-
<p>Previous versions and PGP signatures are always available
at <a
href="http://ftp.gnu.org/gnu/gnuastro";>http://ftp.gnu.org/gnu/gnuastro</a>. Use
<a href="http://ftpmirror.gnu.org/gnuastro";>a
mirror</a> if possible. </p>
@@ -178,6 +157,27 @@ for entertaining and easy to read real world examples of
using
+<h3 id="installation">Installation</h3>
+
+<p>See <a href="manual/html_node/Quick-start.html">Quick start</a> for a fast
+review of the Gnuastro's building and installation commands.</p>
+
+<p>Gnuastro only has three mandatory
+dependencies: <a href="manual/html_node/CFITSIO.html">CFITSIO</a>, <a
href="manual/html_node/WCSLIB.html">WCSLIB</a>
+and <a href="manual/html_node/GNU-Scientific-Library.html">GNU Scientific
+Library</a> (GSL).</p>
+
+<p>For a more detailed description, see
+the <a href="manual/html_node/Installation.html">Installation</a> chapter
+of the <a href="manual/">Gnuastro book</a>. It thoroughly discusses
+the <a href="manual/html_node/Dependencies.html">dependencies</a>,
+<a href="manual/html_node/Downloading-the-source.html">downloading
+methods</a>, and
+the <a href="manual/html_node/Build-and-install.html">building and
+installation</a> of Gnuastro.
+
+
+
<h3 id="documentation">Gnuastro book (documentation)</h3>