Healpix Fortran90 Subroutines Overview

Total Page：16

File Type：pdf, Size：1020Kb

HEALPix Fortran90 Subroutines Overview Revision: Version 2.15a; June 18, 2010 Prepared by: Eric Hivon, Hans K. Eriksen, Frode K. Hansen, Ben- jamin D. Wandelt, Krzysztof M. Górski, Anthony J. Banday and Martin Reinecke Abstract: This document is an overview of the HEALPix For- tran90 subroutines. 2 HEALPix Fortran90 Subroutines Overview Contents Conventions . 6 Changes between release 2.13 and 2.14 . 6 Changes between release 2.0 and 2.13 . 6 Changes between release 1.2 and 2.0 . 7 Changes between release 1.1 and 1.2 . 8 add card . 10 add dipole* . 12 alm2cl* . 14 alm2map* . 16 alm2map der* . 19 alm2map spin* . 22 alms2fits* . 25 alter alm*....................................... 28 ang2vec . 31 angdist . 32 assert, assert alloc, assert directory present, assert not present, assert present . 34 brag openmp . 36 complex fft ...................................... 37 compute statistics* . 38 concatnl . 40 convert inplace* . 42 convert nest2ring* . 44 convert ring2nest* . 46 coordsys2euler zyz .................................. 48 create alm* . 50 del card ........................................ 55 dump alms* . 57 fits2alms* . 59 fits2cl* . 62 gaussbeam . 64 generate beam .................................... 66 get card . 68 HEALPix 2.15a CONTENTS 3 get healpix data dir, get healpix main dir, get healpix test dir . 70 getArgument . 71 getEnvironment . 72 getdisc ring . 73 getnumext fits..................................... 74 getsize fits....................................... 76 healpix modules module . 79 healpix types module . 80 in ring . 82 input map* . 84 input tod*....................................... 86 map2alm* . 88 map2alm iterative* . 91 map2alm spin* . 95 medfiltmap* . 98 median* . 100 merge headers . 102 mpi alm tools* . 104 mpi alm2map* . 106 mpi alm2map simple* . 108 mpi alm2map slave . 110 mpi cleanup alm tools . 112 mpi initialize alm tools . 114 mpi map2alm* . 117 mpi map2alm simple* . 119 mpi map2alm slave . 121 nArguments . 123 neighbours nest . 124 npix2nside . 126 nside2npix . 127 nside2ntemplates . 128 number of alms . 130 output map* . 132 parse xxx ....................................... 134 HEALPix 2.15a 4 HEALPix Fortran90 Subroutines Overview pixel window . 138 pix2xxx,ang2xxx,vec2xxx, nest2ring,ring2nest . 140 planck rng derived type . 143 plm gen . 144 query disc . 147 query polygon . 149 query strip . 151 query triangle . 153 rand gauss . 155 rand init . 157 rand uni........................................ 159 read asctab* . 161 read bintab* . 162 read conbintab* . 164 read dbintab . 166 read fits cut4 . 168 read par........................................ 170 real fft......................................... 172 remove dipole* . 173 ring analysis . 176 ring num........................................ 178 ring synthesis . 180 rotate alm* . 182 same shape pixels nest, same shape pixels ring . 185 scan directories . 188 string, strlowcase, strupcase . 190 surface triangle . 192 template pixel nest, template pixel ring . 194 udgrade nest* . 197 udgrade ring* . 200 vec2ang . 203 vect prod ....................................... 204 write asctab* . 205 write bintab* . 207 HEALPix 2.15a CONTENTS 5 write bintabh . 209 write dbintab . 212 write fits cut4 . 213 write minimal header . 216 write plm . ..

222

Copy Link

Recommended publications

Rcosmo: R Package for Analysis of Spherical, Healpix and Cosmological Data Arxiv:1907.05648V1 [Stat.CO] 12 Jul 2019
CONTRIBUTED RESEARCH ARTICLE 1 rcosmo: R Package for Analysis of Spherical, HEALPix and Cosmological Data Daniel Fryer, Ming Li, Andriy Olenko Abstract The analysis of spatial observations on a sphere is important in areas such as geosciences, physics and embryo research, just to name a few. The purpose of the package rcosmo is to conduct efficient information processing, visualisation, manipulation and spatial statistical analysis of Cosmic Microwave Background (CMB) radiation and other spherical data. The package was developed for spherical data stored in the Hierarchical Equal Area isoLatitude Pixelation (Healpix) representation. rcosmo has more than 100 different functions. Most of them initially were developed for CMB, but also can be used for other spherical data as rcosmo contains tools for transforming spherical data in cartesian and geographic coordinates into the HEALPix representation. We give a general description of the package and illustrate some important functionalities and benchmarks. Introduction Directional statistics deals with data observed at a set of spatial directions, which are usually positioned on the surface of the unit sphere or star-shaped random particles. Spherical methods are important research tools in geospatial, biological, palaeomagnetic and astrostatistical analysis, just to name a few. The books (Fisher et al., 1987; Mardia and Jupp, 2009) provide comprehensive overviews of classical practical spherical statistical methods. Various stochastic and statistical inference modelling issues are covered in (Yadrenko, 1983; Marinucci and Peccati, 2011). The CRAN Task View Spatial shows several packages for Earth-referenced data mapping and analysis. All currently available R packages for spherical data can be classified in three broad groups. The first group provides various functions for working with geographic and spherical coordinate systems and their visualizations.
[Show full text]
Comparison of Spherical Cube Map Projections Used in Planet-Sized Terrain Rendering
FACTA UNIVERSITATIS (NIS)ˇ Ser. Math. Inform. Vol. 31, No 2 (2016), 259–297 COMPARISON OF SPHERICAL CUBE MAP PROJECTIONS USED IN PLANET-SIZED TERRAIN RENDERING Aleksandar M. Dimitrijević, Martin Lambers and Dejan D. Ranˇcić Abstract. A wide variety of projections from a planet surface to a two-dimensional map are known, and the correct choice of a particular projection for a given application area depends on many factors. In the computer graphics domain, in particular in the field of planet rendering systems, the importance of that choice has been neglected so far and inadequate criteria have been used to select a projection. In this paper, we derive evaluation criteria, based on texture distortion, suitable for this application domain, and apply them to a comprehensive list of spherical cube map projections to demonstrate their properties. Keywords: Map projection, spherical cube, distortion, texturing, graphics 1. Introduction Map projections have been used for centuries to represent the curved surface of the Earth with a two-dimensional map. A wide variety of map projections have been proposed, each with different properties. Of particular interest are scale variations and angular distortions introduced by map projections – since the spheroidal surface is not developable, a projection onto a plane cannot be both conformal (angle- preserving) and equal-area (constant-scale) at the same time. These two properties are usually analyzed using Tissot’s indicatrix. An overview of map projections and an introduction to Tissot’s indicatrix are given by Snyder [24]. In computer graphics, a map projection is a central part of systems that render planets or similar celestial bodies: the surface properties (photos, digital elevation models, radar imagery, thermal measurements, etc.) are stored in a map hierarchy in different resolutions.
[Show full text]
Healpix Mapping Technique and Cartographical Application Omur Esen , Vahit Tongur , Ismail Bulent Gundogdu Abstract Hierarchical
HEALPix Mapping Technique and Cartographical Application Omur Esen1, Vahit Tongur2, Ismail Bulent Gundogdu3 1Selcuk University, Construction Offices and Infrastructure Presidency, [email protected] 2Necmettin Erbakan University, Computer Engineering Department of Engineering and Architecture Faculty, [email protected] 3Selcuk University, Geomatics Engineering Department of Engineering Faculty, [email protected] Abstract Hierarchical Equal Area isoLatitude Pixelization (HEALPix) system is defined as a layer which is used in modern astronomy for using pixelised data, which are required by developed detectors, for a fast true and proper scientific comment of calculation algoritms on spherical maps. HEALPix system is developed by experiments which are generally used in astronomy and called as Cosmic Microwave Background (CMB). HEALPix system reminds fragment of a sphere into 12 equal equilateral diamonds. In this study aims to make a litetature study for mapping of the world by mathematical equations of HEALPix celling/tesellation system in cartographical map making method and calculating and examining deformation values by Gauss Fundamental Equations. So, although HEALPix system is known as equal area until now, it is shown that this celling system do not provide equal area cartographically. Keywords: Cartography, Equal Area, HEALPix, Mapping 1. INTRODUCTION Map projection, which is classically defined as portraying of world on a plane, is effected by technological developments. Considering latest technological developments, we can offer definition of map projection as “3d and time varying space, it is the transforming techniques of space’s, earth’s and all or part of other objects photos in a described coordinate system by keeping positions proper and specific features on a plane by using mathematical relation.” Considering today’s technological developments, cartographical projections are developing on multi surfaces (polihedron) and Myriahedral projections which is used by Wijk (2008) for the first time.
[Show full text]
Octahedron-Based Projections As Intermediate Representations for Computer Imaging: TOAST, TEA and More
Draft version December 11, 2018 Typeset using LATEX default style in AASTeX62 Octahedron-Based Projections as Intermediate Representations for Computer Imaging: TOAST, TEA and More. Thomas McGlynn,1 Jonathan Fay,2 Curtis Wong,2 and Philip Rosenfield3 1NASA/Goddard Space Flight Center Greenbelt, MD 20771, USA 2Microsoft Research One Microsoft Way Redmond, WA 98052, USA 3American Astronomical Society 1667 K St NW Suite 800 Washington, DC 20006, USA Submitted to ApJ ABSTRACT This paper defines and discusses a set of rectangular all-sky projections which have no singular points, notably the Tesselated Octahedral Adaptive Spherical Transformation (or TOAST) developed initially for the WorldWide Telescope (WWT). These have proven to be useful as intermediate representations for imaging data where the application transforms dynamically from a standardized internal format to a specific format (projection, scaling, orientation, etc.) requested by the user. TOAST is strongly related to the Hierarchical Triangular Mesh (HTM) pixelization and is particularly well adapted to the situations where one wishes to traverse a hierarchy of increasing resolution images. Since it can be recursively computed using a very simple algorithm it is particularly adaptable to use by graphical processing units. Keywords: Data Analysis and Techniques, Astrophysical Data 1. INTRODUCTION Hundreds of map projections have been developed over the course of many centuries (e.g., see Snyder 1997) trying to represent a spherical surface despite the physical realities of publishing information on flat sheets of paper and monitors. Different projections are designed to meet different goals: the Mercator projection is designed to ease navigation, it accurately represents the directions between nearby points so that a sailor can steer a boat properly.
[Show full text]
A Square Equal-Area Map Projection Withlow Angular Distortion
A Square Equal-area Map Projection with Low Angular Distortion, Minimal Cusps, and Closed-form Solutions MATTHEW A. PETROFF, Johns Hopkins University, USA A novel square equal-area map projection is proposed. The projection combines closed-form forward and inverse solutions with relatively low angular distortion and minimal cusps, a com- bination of properties not manifested by any previously published square equal-area projection. Thus, the new projection has lower angular distortion than any previously published square equal-area projection with a closed-form solution. Utilizing a quincuncial arrangement, the new projection places the north pole at the center of the square and divides the south pole between its four corners; the projection can be seamlessly tiled. The existence of closed-form solutions makes the projection suitable for real-time visualization applications, both in cartography and in other areas, such as for the display of panoramic images. CCS Concepts: • Human-centered computing Geographic visualization; • Computing ! methodologies Image processing. ! Additional Key Words and Phrases: map projection, world map, equal-area, quincuncial, panoramic images, sky maps 1 INTRODUCTION Although there is a plenitude of map projections [21], there has been relatively little work done on square equal-area projections. As noted by Gringorten [9], a square aspect ratio is useful for printed atlases, since it allows for a standard page to be efficiently filled with a map along with a title and descriptive caption. Equal-area projections are useful for displaying climatology and population data on the Earth, as well as for displaying cosmology data on the celestial sphere. Mappings from the sphere to the square are also useful in computer graphics applications, such as the display of panoramic images, since textures used by graphic processing units (GPUs) are often square.
[Show full text]
3.1 RING and NESTED Numbering Schemes
The HEALPix Primer Revision: Version 3.80; June 22, 2021 Prepared by: Krzysztof M. Górski, Benjamin D. Wandelt, Eric Hivon, Frode K. Hansen, and Anthony J. Banday Abstract: HEALPix is a Hierarchical, Equal Area, and iso- Latitude Pixelation of the sphere designed to sup- port eﬃciently (1) local operations on the pixel set, (2) a hierarchical tree structure for multi-resolution applications, and (3) the global Fast Spherical Har- monic transform. HEALPix based mathematical software meets the challenges presented by high reso- lution and large volume data sets, such as the WMAP and Planck CMB mission products. https://healpix.sourceforge.io http://healpix.sf.net 2 The HEALPix Primer TABLE OF CONTENTS 1 Introduction3 2 Discretisation of Functions on the Sphere4 3 Geometric and Algebraic Properties of HEALPix6 3.1 RING and NESTED numbering schemes................... 7 3.2 The Unique Identiﬁer scheme ......................... 9 4 The HEALPix Software Package 10 4.1 Contents and purposes............................. 10 4.2 Licensing..................................... 11 A HEALPix conventions 12 A.1 Angular power spectrum conventions..................... 12 A.2 HEALPix and Boltzmann codes....................... 13 A.2.1 CMBFAST ............................... 13 A.2.2 CAMB and CLASS........................... 14 A.3 Polarisation convention............................. 14 A.3.1 Internal convention........................... 14 A.3.2 Relation to previous releases...................... 18 A.3.3 Relation with IAU convention..................... 19 A.3.4 How HEALPix deals with these discrepancies: POLCCONV keyword 20 A.4 Spherical harmonic conventions ........................ 21 B Pixel window functions 21 C A Comment on the Random Number Generator 23 D Finite precision and cross-platform reproducibility 23 References 24 HEALPix 3.80 Introduction 3 1 Introduction The analysis of functions on domains with spherical topology occupies a central place in physical science and engineering disciplines.
[Show full text]
The Healpix Primer
The HEALPix Primer Revision: Version 2.15a; June 18, 2010 Prepared by: Krzysztof M. Górski, Benjamin D. Wandelt, Eric Hivon, Frode K. Hansen, and Anthony J. Banday Abstract: HEALPix is a Hierarchical, Equal Area, and iso- Latitude Pixelisation of the sphere designed to sup- port efficiently (1) local operations on the pixel set, (2) a hierarchical tree structure for multi-resolution applications, and (3) the global Fast Spherical Har- monic transform. HEALPix based mathematical software meets the challenges which future high reso- lution and large volume CMB data sets, including the WMAP and Planck mission products, will present. 2 The HEALPix Primer TABLE OF CONTENTS 1 Introduction . 3 2 Discretisation of Functions on the Sphere . 4 3 Geometric and Algebraic Properties of HEALPix ............. 6 4 The HEALPix Software Package . 9 A HEALPix conventions . 11 A.1 Angular power spectrum conventions . 11 A.2 HEALPix and CMBFAST . 12 A.3 Polarisation convention . 13 A.3.1 Internal convention . 13 A.3.2 Relation to previous releases . 16 A.3.3 Relation with IAU convention . 17 A.4 Spherical harmonic conventions . 19 B Pixel window functions . 19 C A Comment on the Random Number Generator . 21 HEALPix 2.15a Introduction 3 1 Introduction The analysis of functions on domains with spherical topology occupies a central place in physical science and engineering disciplines. This is particularly apparent in the fields of astronomy, cosmology, geophysics, atomic and nuclear physics. In many cases the geometry is either dictated by the object under study or approximate spherical symmetry can be exploited to yield powerful perturbation methods.
[Show full text]
Multi-Resolution Data Structures for Spherically Mapped Point Data
MULTI-RESOLUTION DATA STRUCTURES FOR SPHERICALLY MAPPED POINT DATA by ROBERT WILLIAM YOUNGREN A DISSERTATION Submitted in partial fulfillment of the requirements for the Degree of Doctor of Philosophy in Computer Science to The School of Graduate Studies of The University of Alabama in Huntsville HUNTSVILLE, ALABAMA 2017 ABSTRACT The School of Graduate Studies The University of Alabama in Huntsville Degree Doctor of Philosophy College/Dept Science/Computer Science_ Name of Candidate Robert Youngren__________________________ Title Multi-Resolution Data Structures for Spherically Mapped Point Data_______ Data describing entities or objects whose locations may be treated as points on the surface of a sphere are said to be spherically mapped. A number of data structures specifically designed to store and access spherically mapped data have been developed. One of them, Hierarchical Equal Area iso-Latitude Pixelization (HEALPix), has been successfully used for numerous applications, notably including organizing and analyzing cosmic microwave background data. However, for applications involving relatively sparse spherically mapped point datasets, HEALPix has some drawbacks, including inefficient memory requirements due to fixed resolution, overwriting of data for closely proximate points, and return of spurious points in response to certain queries. A multi-resolution variant of the HEALPix data structure optimized for point data was developed to address these issues. The new data structure is multi-resolution in that different portions of the sphere may be subdivided at different levels of resolution in the same data structure, depending on the data to be stored. It combines the best aspects of iv HEALPix with the advantages of multi-resolution, including reduced memory requirements, improved query efficiency, and flexible handling of proximate points.
[Show full text]
Healpix IDL Facilities Overview
HEALPix IDL Facilities Overview Revision: Version 3.80; June 22, 2021 Prepared by: Eric Hivon, Anthony J. Banday, Benjamin D. Wan- delt, Frode K. Hansen and Krzysztof M. Góorski Abstract: This document is an overview of the HEALPix IDL facilities. https://healpix.sourceforge.io http://healpix.sf.net 2 HEALPix IDL Facilities Overview TABLE OF CONTENTS Using the HEALPix-IDL facilities.........................5 Using HEALPix-IDL together with other IDL libraries.............5 Using GDL or FL instead of IDL..........................6 What is available?..................................6 Maps related tools..................................6 Pixels related tools..................................7 Power spectrum, alm, beam and pixel window functions.............7 Other tools......................................7 Changes in release 3.80................................8 Previous changes...................................8 alm_i2t........................................ 13 alm_t2i........................................ 15 alm2ﬁts........................................ 17 ang2vec........................................ 20 angulardistance.................................... 22 azeqview........................................ 24 beam2bl........................................ 26 bin_llcl........................................ 28 bl2beam........................................ 30 bl2ﬁts......................................... 32 cartcursor....................................... 34 cartview........................................ 35 change_polcconv..................................
[Show full text]
Splitting the Sky - HTM and Healpix
MPA/ESO/MPE Joint Astronomy Conference Mining The Sky 2000 Splitting the sky - HTM and HEALPix. W. O’Mullane Astrophysics Division, Space Science Department of ESA, ESTEC, 2200 AG Noordwijk, The Netherlands. A. J. Banday MPI für Astrophysik, P.O. Box 1523, D-85740 Garching, Germany. K. Gorski European Southern Observatory (ESO), Karl Schwarzschild Strasse 2, 85748 Garching, Germany P. Kunszt, A. Szalay The Johns Hopkins University, 3701 San Martin Drive, Baltimore, MD 21218, USA. Abstract: Mission data sets are increasing in size and complexity. To enable efﬁcient processing and storage of such data sets a tessellation scheme may be adopted. The Hierarchical Triangular Mesh (HTM) and the Hierarchical Equal Area isoLatitude Pixelisation (HEALPix) schemes are two popular schemes each with software tools available to exploit their particular properties. The initial drivers behind these two schemes are quite different but as their use continues the complimentary facilities of each package will become more relevant. Here we describe the motivation and facilities of HEALPix and HTM, we ask if it is possible to combine these schemes or make use of them in a combined manner and say why we may wish to do this. 1. Motivation The data avalanche was mentioned a few times during this conference. Only an organised approach will enable us to deal with the large quantities of data being produced by new missions such as the Sloan Digitized Sky Survey, GAIA and Planck. Part of this organised approach is the adoption of a tessellation scheme to enable partitioning of the data. Several schemes now exist leaving many people in a quandary as to which they should use.
[Show full text]
CONVERSION of ECP MAPS INTO Healpix MAPS L. La Porta1, P
MPIfR - Memo 2005/1 CONVERSION OF ECP MAPS INTO Healpix MAPS L. La Porta1, P. Reich1, C. Burigana2, W. Reich1 1 MPIfR, Bonn, Germany 2 INAF-IASF, CNR, Bologna, Italy November 2005 1 MPIfR - Memo 2005/1 CONVERSION OF ECP MAPS INTO Healpix MAPS L. La Porta1, P. Reich1, C. Burigana2, W. Reich1 1 MPIfR, Bonn, Germany 2 INAF-IASF, CNR, Bologna, Italy We describe a method developed to convert the cartesian all-sky map at 1420 MHz into Healpix, the format conventionally adopted in the experiments dedicated to Cosmic Microwave Background anisotropies. We checked the reliability of the elaborated recipy by successfully performing a forward and backward transformation between the two pix- elization schemes, confirming that no informations have been lost in the reprojection of the > data at the relevant scales (θ ∼ θHPBW ). The implemented algorithm has been exploited to project the 408 MHz map and the DRAO 1420 MHz polarization map into Healpix as well. The mentioned surveys are relevant not only for evaluating the impact of the Galactic diffuse synchrotron emission on CMB anisotropies measurements, but also for investigating its statistical properties in the context of the foreground separation problem. 2 1 Introduction In the perspective of the CMB dedicated space missions WMAP1 (ongoing) and Planck2 (planned for next year), the angular power spectrum3 analysis has been extended to the foregrounds expected to contamine the cosmological signal. With regard to the Galactic synchrotron radiation, dominant over the other diffuse components (Bremsstrahlung and thermal and non-thermal dust emission) at about 1 GHz, the map providing the deepest insights into its statistical properties (because characterized by good sensitivity and complete coverage) is the full-sky total intensity map at 1420 MHz ( Reich 1982 ; Reich & Reich 1986; Reich et al.
[Show full text]
Flattening the Sky with Healpix
Flattening the Sky with HEALPix Krzysztof M. Górski Jet Propulsion Laboratory, California Institute of Technology Pasadena, CA & Astronomical Observatory, Warsaw University, Poland `INPE School on Astrophysics, Sept. 2013 HEALPix ! Hierarchical Equal Area iso-Latitude Pixelization ! HEALPix was constructed to support: –" Hierarchical structure of the data base for data objects distributed on the sphere –" Exactly equal area of pixels - resolution elements of the tessellation –" Iso-latitude distribution of pixel centers, which constitute the point-set for numerical quadrature on the sphere to enable fast spherical harmonic transforms [Plm(θ) only need to be evaluated once per latitude, hence overall complexity of harmonic 3/2 transform evaluations is ~Npix , where Npix is the total number of pixels on the sky] ! HEALPix was invented (~16 years ago!) by K.M. Górski (then in Copenhagen), and developed and supported by KMG (now at JPL/Caltech), Eric Hivon (IAP, France), A.J. Banday (MPA Garching, Germany), B.D. Wandelt (UIUC, IL), M. Reinecke (MPA Garching, Germany) ! HEALPix software is a suite of Fortran90, IDL, C, C++, Python, and Java programs for data digitization, manipulation, and mathematical analysis, including fast spherical harmonic synthesis/analysis transforms, with documentation and user manuals ! HEALPix is the data structure for WMAP, and Planck; it is an adopted data standard in FITS, etc. ! Distributed through the web-site http://healpix.sourceforge.net (http://healpix.jpl.nasa.gov) ! Contact: [email protected] & [email protected] Krzysztof M. Górski INPE School on Astrophysics, Sept. 2013 Almost 50 years since the discovery of the CMB, after scores of suborbital CMB experiments, and two decades of 3 dedicated satellite missions – we reached a REMARKABLE moment, but why are we doing this? Krzysztof M.
[Show full text]