|
udgrade_ring*
Routine to degrade or prograde the pixel size of a HEALPix map indexed with
the RING scheme. The degradation/progradation is done assuming an
intensive quantity (like temperature) that does NOT scale with surface area.
In case of degradation, a big pixel that contains one or several bad pixels will
take the average of the valid small pixels, unless a 'pessimistic' behavior
is assumed in which case the big pixel will take the bad pixel sentinel value.
In case of progradation, a bad pixel only spawns bad pixels.
The routine accepts both mono and bi-dimensional maps.
Location in HEALPix directory tree:
src/f90/mod/udgrade_nr.f90
FORMAT call udgrade_ring*(
map_in, nside_in, map_out, nside_out [, fmissval, pessimistic]
)
ARGUMENTS
| name & dimensionality |
kind |
in/out |
description |
|---|
| |
|
|
|
|
map_in(0:12*nside_in**2-1) |
SP/ DP |
INOUT |
mono-dimensional full sky map to be
prograded or degraded. The routine finds the second
dimension (nd) by itself. Note that the map is modified on
output (reordered into NESTED scheme). |
| map_in(0:12*nside_in**2-1,1:nd) |
SP/ DP |
INOUT |
bi-dimensional full sky map to be
prograded or degraded. Note that the map is modified on
output (reordered into NESTED scheme). |
| nside_in |
I4B |
IN |
the Nside resolution parameter of the input
map. Must be a power of 2. |
| map_out(0:12*nside_out**2-1) |
SP/ DP |
OUT |
mono-dimensional full sky map after
degradation or progradation. |
| map_out(0:12*nside_out**2-1,1:nd) |
SP/ DP |
OUT |
bi-dimensional full sky map after
degradation or progradation. The second dimension
(nd) should match that of the input map. |
| nside_out |
I4B |
IN |
the Nside resolution parameter of the output
map. Must be a power of 2. If nside_out > nside_in, the
map is prograded (ie, more and smaller pixels) with each
pixel having the same value as its parent; otherwise, the
map in degraded (ie, fewer larger pixels), with each pixel
being the average of its (nside_in/nside_out)2 components. |
| fmissval (OPTIONAL) |
SP/ DP |
IN |
sentinel value given to bad pixels in input and output
maps. default:
 |
| pessimistic (OPTIONAL) |
LGT |
IN |
if set to .true., during a degradation, a big pixel containing at least a small
bad pixel will be returned as bad as well, instead of taking
the average of the remaing valid pixels. default:.false. |
EXAMPLE:
call udgrade_ring(map_hi, 256, map_low, 64)
Degrades a RING ordered map with Nside=256 into a RING map with Nside=64
RELATED ROUTINESThis section lists the routines related to udgrade_ring*
-
udgrade_nest
- prograde or degrade a NESTED
ordered map.
Eric Hivon
2010-06-18
|
|
