[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[gnuastro-commits] master 4f4d3a2 2/2: Book: further clarification of Ar
From: |
Mohammad Akhlaghi |
Subject: |
[gnuastro-commits] master 4f4d3a2 2/2: Book: further clarification of Arithmetic's interpolate-medianngb |
Date: |
Wed, 28 Oct 2020 06:02:26 -0400 (EDT) |
branch: master
commit 4f4d3a2430d192f02018b281b08990eed5afafdc
Author: Mohammad Akhlaghi <mohammad@akhlaghi.org>
Commit: Mohammad Akhlaghi <mohammad@akhlaghi.org>
Book: further clarification of Arithmetic's interpolate-medianngb
Until now, the description of this operator was very minimalistic and could
lead to users assuming that the first popped operand is a radius rather
than the number.
With this commit, a more detailed description has been added, describing
how it works.
---
doc/gnuastro.texi | 14 ++++++++++----
1 file changed, 10 insertions(+), 4 deletions(-)
diff --git a/doc/gnuastro.texi b/doc/gnuastro.texi
index 584b3ef..12ca0b0 100644
--- a/doc/gnuastro.texi
+++ b/doc/gnuastro.texi
@@ -11167,16 +11167,22 @@ Apply a @mymath{\sigma}-clipped median filtering onto
the input dataset.
This operator and its necessary operands are almost identical to
@code{filter-sigclip-mean}, except that after @mymath{\sigma}-clipping, the
median value (which is less affected by outliers than the mean) is added back
to the stack.
@item interpolate-medianngb
-Interpolate all the blank elements of the second popped operand with the
median of its nearest non-blank neighbors.
+Interpolate the blank elements of the second popped operand with the median of
nearest non-blank neighbors to each.
The number of the nearest non-blank neighbors used to calculate the median is
given by the first popped operand.
-Note that the distance of the nearest non-blank neighbors is irrelevant in
this interpolation.
-For example the line below calculates the median using 4 pixels.
+The distance of the nearest non-blank neighbors is irrelevant in this
interpolation.
+The neighbors of each blank pixel will be parsed in expanding circluar rings
(for 2D images) or spherical surfaces (for 3D cube) and each non-blank element
over them is stored in memory.
+When the requested number of non-blank neighbors have been found, their median
is used to replace that blank element.
+For example the line below replaces each blank element with the the median of
the nearest 5 pixels.
@example
-$ astarithmetic image.fits 4 interpolate-medianngb
+$ astarithmetic image.fits 5 interpolate-medianngb
@end example
+When you want to interpolate blank regions and you want each blank region to
have a fixed value (for example the centers of saturated stars) this operator
is not good.
+Because the pixels used to interpolate various parts of the region differ.
+For such scenarios, you may use @code{interpolate-maxofregion} or
@code{interpolate-inofregion} (described below).
+
@item interpolate-minngb
Similar to @code{interpolate-medianngb}, but will fill the blank values of the
dataset with the minimum value of the nearest neighbors.