Commit 010e916d authored by Maude Le Jeune's avatar Maude Le Jeune
Browse files

+doc

parent 546664ac
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"
lang="en" xml:lang="en">
<head>
<title>Needlet ILC tool</title>
<meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"/>
<meta name="generator" content="Org-mode"/>
<meta name="generated" content="2011-01-05 13:58:59 CET"/>
<meta name="author" content="M. Le Jeune"/>
<meta name="description" content=""/>
<meta name="keywords" content=""/>
<style type="text/css">
<!--/*--><![CDATA[/*><!--*/
html { font-family: Times, serif; font-size: 12pt; }
.title { text-align: center; }
.todo { color: red; }
.done { color: green; }
.tag { background-color: #add8e6; font-weight:normal }
.target { }
.timestamp { color: #bebebe; }
.timestamp-kwd { color: #5f9ea0; }
p.verse { margin-left: 3% }
pre {
border: 1pt solid #AEBDCC;
background-color: #F3F5F7;
padding: 5pt;
font-family: courier, monospace;
font-size: 90%;
overflow:auto;
}
table { border-collapse: collapse; }
td, th { vertical-align: top; }
dt { font-weight: bold; }
div.figure { padding: 0.5em; }
div.figure p { text-align: center; }
.linenr { font-size:smaller }
.code-highlighted {background-color:#ffff00;}
.org-info-js_info-navigation { border-style:none; }
#org-info-js_console-label { font-size:10px; font-weight:bold;
white-space:nowrap; }
.org-info-js_search-highlight {background-color:#ffff00; color:#000000;
font-weight:bold; }
/*]]>*/-->
</style>
<link rel="stylesheet" type="text/css" href="org.css" />
<script type="text/javascript">
<!--/*--><![CDATA[/*><!--*/
function CodeHighlightOn(elem, id)
{
var target = document.getElementById(id);
if(null != target) {
elem.cacheClassElem = elem.className;
elem.cacheClassTarget = target.className;
target.className = "code-highlighted";
elem.className = "code-highlighted";
}
}
function CodeHighlightOff(elem, id)
{
var target = document.getElementById(id);
if(elem.cacheClassElem)
elem.className = elem.cacheClassElem;
if(elem.cacheClassTarget)
target.className = elem.cacheClassTarget;
}
/*]]>*///-->
</script>
</head>
<body>
<div id="content">
<h1 class="title">Needlet ILC tool</h1>
<div id="table-of-contents">
<h2>Table of Contents</h2>
<div id="text-table-of-contents">
<ul>
<li><a href="#sec-1">1 Installation </a>
<ul>
<li><a href="#sec-1.1">1.1 Dependencies </a></li>
<li><a href="#sec-1.2">1.2 Installing the NILC tool </a></li>
<li><a href="#sec-1.3">1.3 Running the NILC tool </a></li>
</ul>
</li>
<li><a href="#sec-2">2 Pixel based ILC </a>
<ul>
<li><a href="#sec-2.1">2.1 Full sky analyis </a></li>
<li><a href="#sec-2.2">2.2 Patch analysis </a></li>
<li><a href="#sec-2.3">2.3 Localized analysis </a></li>
</ul>
</li>
<li><a href="#sec-3">3 Needlet ILC </a></li>
<li><a href="#sec-4">4 More options </a></li>
</ul>
</div>
</div>
<div id="outline-container-1" class="outline-2">
<h2 id="sec-1"><span class="section-number-2">1</span> Installation </h2>
<div class="outline-text-2" id="text-1">
<p>
The NILC tool relies on the <b>Healpix</b> C++ library
(<a href="http://healpix.jpl.nasa.gov/">http://healpix.jpl.nasa.gov/</a>) and the <b>spherelib</b> library which
extends the Healpix package with needlet analysis and filtering
routines.
</p>
<p>
Those two libraries are provided and automatically installed with the
NILC source code.
</p>
</div>
<div id="outline-container-1.1" class="outline-3">
<h3 id="sec-1.1"><span class="section-number-3">1.1</span> Dependencies </h3>
<div class="outline-text-3" id="text-1.1">
<p>
To build the binary, you will need the Scons construction tool. Get
it from your package manager or see <a href="http://www.scons.org">http://www.scons.org</a>
</p>
<p>
It is also possible to use scons-local by downloading
scons-local-xxxx.tar.gz, unpacking the tar ball in the current
directory and then running:
<code>python scons.py -f SConstruct_local</code>
after the file <code>SConstruct_local_example</code> has been edited into
<code>SConstruct_local</code> to fit your system.
</p>
</div>
</div>
<div id="outline-container-1.2" class="outline-3">
<h3 id="sec-1.2"><span class="section-number-3">1.2</span> Installing the NILC tool </h3>
<div class="outline-text-3" id="text-1.2">
<p>
Change directory to the NILC source code repository and run:
</p>
<p>
<code>scons</code>
</p>
<p>
To clean up after a build:
</p>
<p>
<code>scons -c</code>
</p>
<p>
To install the binary:
</p>
<p>
<code>scons install --prefix=mydir</code>
</p>
<p>
Default prefix is '/usr/local'.
</p>
</div>
</div>
<div id="outline-container-1.3" class="outline-3">
<h3 id="sec-1.3"><span class="section-number-3">1.3</span> Running the NILC tool </h3>
<div class="outline-text-3" id="text-1.3">
<p>
A simple test can be run using the simulated data provided with the
NILC package:
</p>
<p>
<code>nilc fullsky.param</code>
</p>
</div>
</div>
</div>
<div id="outline-container-2" class="outline-2">
<h2 id="sec-2"><span class="section-number-2">2</span> Pixel based ILC </h2>
<div class="outline-text-2" id="text-2">
<p>
The NILC tool can be used for pixel-based analysis performed:
</p><ul>
<li>
on the full sky;
</li>
<li>
on a patch or using a galactic mask;
</li>
<li>
on a set of pixel zones.
</li>
</ul>
</div>
<div id="outline-container-2.1" class="outline-3">
<h3 id="sec-2.1"><span class="section-number-3">2.1</span> Full sky analyis </h3>
<div class="outline-text-3" id="text-2.1">
<p>
In this case, input parameters are minimum as in this simple example:
</p>
<p>
<a href="./fullsky.param">file:./fullsky.param</a>
</p>
</div>
</div>
<div id="outline-container-2.2" class="outline-3">
<h3 id="sec-2.2"><span class="section-number-3">2.2</span> Patch analysis </h3>
<div class="outline-text-3" id="text-2.2">
<p>
In order to exclude a zone of the analysis, one can define a binary
mask which is an Healpix map with pixel equal to 0 in the excluded
zone and 1 elsewhere:
</p>
<p>
<a href="./patch.param">file:./patch.param</a>
</p>
</div>
</div>
<div id="outline-container-2.3" class="outline-3">
<h3 id="sec-2.3"><span class="section-number-3">2.3</span> Localized analysis </h3>
<div class="outline-text-3" id="text-2.3">
<p>
In order to performed a space localized ILC, this Healpix map can be
used to define more pixel zones.
In this case, each pixel is set to its zone number starting from 1:
</p>
<p>
<a href="./grid.param">file:./grid.param</a>
</p>
</div>
</div>
</div>
<div id="outline-container-3" class="outline-2">
<h2 id="sec-3"><span class="section-number-2">3</span> Needlet ILC </h2>
<div class="outline-text-2" id="text-3">
<p>
The Needlet ILC is based on the possibility to localized the
statistics over both space and spectral domains.
</p>
<p>
The spectral localisation is made available through the use of spline
window functions. Window function limits are set in a vector with the
following convention:
<code>bands=[lmin_0 lmin_1 lmin_2...lmin_J lmin_J-1 lmax_J]</code>
with <code>lmax_j-2=lmin_j</code>.
</p>
<p>
The space localisation uses the same convention as described in the
previous section, except that one has to define as many Healpix zone
maps as needlet scales (J in this example).
</p>
<p>
<a href="./needlet.param">file:./needlet.param</a>
</p>
</div>
</div>
<div id="outline-container-4" class="outline-2">
<h2 id="sec-4"><span class="section-number-2">4</span> More options </h2>
<div class="outline-text-2" id="text-4">
<ul>
<li>
Input files are Healpix map by default. It is possible to use alm
files instead by setting the option almopt to <code>true</code>. In this case,
one has to specify which resolution will be used for the output map
with the <code>nside</code> parameter.
</li>
<li>
Spherical harmonic transforms can be tuned with the <code>n_iter</code>
parameter.
</li>
<li>
One can use command line options instead of parameter file:
<ul>
<li>
In the pixel based case:
<code>nilc -p outfile -z zonefile N infile1 coeff1 ... infileN coeffN</code>
</li>
<li>
In the needlet case:
<code>nilc outfile l0 J zonefile1 lmax1 ... zonefileJ lmaxJ N infile1 coeff1 ... infileN coeffN</code>
</li>
</ul>
</li>
</ul>
</div>
</div>
<div id="postamble">
<p class="author"> Author: M. Le Jeune
<a href="mailto:lejeune@apc.univ-paris7.fr">&lt;lejeune@apc.univ-paris7.fr&gt;</a>
</p>
<p class="date"> Date: 2011-01-05 13:58:59 CET</p>
<p class="creator">HTML generated by org-mode 6.33x in emacs 23</p>
</div>
</div>
</body>
</html>
infile = file1.fits file2.fits file3.fits
mixcol = 1 1 1
outfile = cmb.fits
\ No newline at end of file
infile = file1.fits file2.fits file3.fits
mixcol = 1 1 1
outfile = cmb.fits
zonefile = grid.fits
\ No newline at end of file
infile = file1.fits file2.fits file3.fits
mixcol = 1 1 1
outfile = cmb.fits
zonefile = grid1.fits grid2.fits
bands = 0 256 512 1024
\ No newline at end of file
@media all
{
body {
font-size: 11pt;
text-align: left;
line-height:1.2em;
}
h1 {font-size: 14pt;}
#table-of-contents {
font-size: 85%;
line-height: 1.4em;
}
#table-of-contents ul {
list-style: none;
margin: 7px 0px 7px 15px ;
padding: 0px;
}
.title {
padding-bottom: 7px;
margin-bottom: 20px;
border-bottom: 1px solid #222;
}
h2 {
font-size: 12pt;
padding-bottom: 4px;
margin-top: 5px;
margin-bottom: 5px;
border-bottom: 1px solid #DDD;
}
h3 {font-size: 11pt; color: #a34d32;}
h4 {font-size: 9pt;}
a {text-decoration: none; color: #537d7b}
/* a:visited {text-decoration: none; color: #224444} */ /* Taken out because color too similar to text. */
a:visited {text-decoration: none; color: #98855b} /* this is now the color of the Unicorns horn */
a:hover {text-decoration: underline; color: #a34d32}
.todo {color: #990000;}
.done {color: #006666;}
.timestamp-kwd {color: #444;}
.tag {color: #DDD; font-size: 70%; font-weight: 500;}
table {border: none;}
td {border: none; padding: .1em .7em .1em .3em;}
th {border: none;}
code {font-size: 10pt;}
pre {
border: 1px solid #555;
background: #EEEEEE;
font-size: 11pt;
padding: 1em;
}
img {
border: none;
}
.share img {
opacity: .4;
-moz-opacity: .4;
filter: alpha(opacity=40);
}
.share img:hover {
opacity: 1;
-moz-opacity: 1;
filter: alpha(opacity=100);
}
.org-info-search-highlight
{
background-color:#adefef; /* same color as emacs default */
color:#000000;
font-weight:bold;
}
.org-bbdb-company {
/* bbdb-company */
font-style: italic;
}
.org-bbdb-field-name {
}
.org-bbdb-field-value {
}
.org-bbdb-name {
/* bbdb-name */
text-decoration: underline;
}
.org-bold {
/* bold */
font-weight: bold;
}
.org-bold-italic {
/* bold-italic */
font-weight: bold;
font-style: italic;
}
.org-border {
/* border */
background-color: #000000;
}
.org-buffer-menu-buffer {
/* buffer-menu-buffer */
font-weight: bold;
}
.org-builtin {
/* font-lock-builtin-face */
color: #da70d6;
}
.org-button {
/* button */
text-decoration: underline;
}
.org-c-nonbreakable-space {
/* c-nonbreakable-space-face */
background-color: #ff0000;
font-weight: bold;
}
.org-calendar-today {
/* calendar-today */
text-decoration: underline;
}
.org-comment {
/* font-lock-comment-face */
color: #b22222;
}
.org-comment-delimiter {
/* font-lock-comment-delimiter-face */
color: #b22222;
}
.org-constant {
/* font-lock-constant-face */
color: #5f9ea0;
}
.org-cursor {
/* cursor */
background-color: #000000;
}
.org-default {
/* default */
color: #000000;
background-color: #ffffff;
}
.org-diary {
/* diary */
color: #ff0000;
}
.org-doc {
/* font-lock-doc-face */
color: #bc8f8f;
}
.org-escape-glyph {
/* escape-glyph */
color: #a52a2a;
}
.org-file-name-shadow {
/* file-name-shadow */
color: #7f7f7f;
}
.org-fixed-pitch {
}
.org-fringe {
/* fringe */
background-color: #f2f2f2;
}
.org-function-name {
/* font-lock-function-name-face */
color: #0000ff;
}
.org-header-line {
/* header-line */
color: #333333;
background-color: #e5e5e5;
}
.org-help-argument-name {
/* help-argument-name */
font-style: italic;
}
.org-highlight {
/* highlight */
background-color: #b4eeb4;
}
.org-holiday {
/* holiday */
background-color: #ffc0cb;
}
.org-info-header-node {
/* info-header-node */
color: #a52a2a;
font-weight: bold;
font-style: italic;
}
.org-info-header-xref {
/* info-header-xref */
color: #0000ff;
text-decoration: underline;
}
.org-info-menu-header {
/* info-menu-header */
font-weight: bold;
}
.org-info-menu-star {
/* info-menu-star */
color: #ff0000;
}
.org-info-node {
/* info-node */
color: #a52a2a;
font-weight: bold;
font-style: italic;
}
.org-info-title-1 {
/* info-title-1 */
font-size: 172%;
font-weight: bold;
}
.org-info-title-2 {
/* info-title-2 */
font-size: 144%;
font-weight: bold;
}
.org-info-title-3 {
/* info-title-3 */
font-size: 120%;
font-weight: bold;
}
.org-info-title-4 {
/* info-title-4 */
font-weight: bold;
}
.org-info-xref {
/* info-xref */
color: #0000ff;
text-decoration: underline;
}
.org-isearch {
/* isearch */
color: #b0e2ff;
background-color: #cd00cd;
}
.org-italic {
/* italic */
font-style: italic;
}
.org-keyword {
/* font-lock-keyword-face */
color: #a020f0;
}
.org-lazy-highlight {
/* lazy-highlight */
background-color: #afeeee;
}
.org-link {
/* link */
color: #0000ff;
text-decoration: underline;
}
.org-link-visited {
/* link-visited */
color: #8b008b;
text-decoration: underline;
}
.org-match {
/* match */
background-color: #ffff00;
}
.org-menu {
}
.org-message-cited-text {
/* message-cited-text */
color: #ff0000;
}
.org-message-header-cc {
/* message-header-cc */
color: #191970;
}
.org-message-header-name {
/* message-header-name */
color: #6495ed;
}
.org-message-header-newsgroups {
/* message-header-newsgroups */
color: #00008b;
font-weight: bold;