linc-tw / salmo

Fast mocks generation for cosmological analysis

Salmo

Speedy Acquisition for Lensing and Matter Observables
Chieh-An Lin (Institute for Astronomy, University of Edinburgh)
Release v1.0.0 - 2020-07-31

Description

Salmo is a C-based software to generate fast mocks for cosmological analysis with the following characteristics:

• galaxy mocks, with or without lensing signals;
• curved sky;
• can generate multiple tracers coherently;
• each tracer can have its own mask and redshift distribution.

Salmo is designed to be used with the Flask software. The map outputs from Flask or those with the same format are required to generate catalogues. See Usage and Wiki for details.

Installation

Requirements

• cmake
• pkg-config
• gcc
• gsl
• cfitsio

Compilation

For Mac users, do the following before compilation:

$ export CC=gcc
$ export CXX=g++

or use setenv command in tcsh.

To compile the package:

$ cd build
$ cmake ..
$ make

To see if the compilation is successful, please execute:

$ ./salmo

and users will see usage instructions.

Usage

External files to provide

Salmo requires some external files as inputs to work:

• density & lensing maps,
• masks, and
• redshift distributions.

Other values to specify are galaxy number densities & shape noise.

Quick run

With the provided parameter file param/salmoParam.par and input files in demo/input, users can execute:

$ ./salmo default 3

for a quick example run and find catalogues in demo/output.

See Wiki for detailed tutorials.

Instructions reminder

To get program instructions, please execute:

$ ./salmo

Attribution

Please cite the following paper for referencing Salmo:

• Joachimi, Lin, et al. KiDS-1000 Methodology: Modelling and inference for joint weak gravitational lensing and spectroscopic galaxy clustering analysis. Submitted to A&A.

Here are some other works in which Salmo is involved:

• Heymans et al. KiDS-1000 Cosmology: Multi-probe weak gravitational lensing and spectroscopic galaxy clustering constraints. Submitted to A&A.
• Asgari, Lin, et al. KiDS-1000 Cosmology: Cosmic shear constraints and comparison between two point statistics. Submitted to A&A.
• Giblin et al. KiDS-1000 catalogue: weak gravitational lensing shear measurements. Submitted to A&A.
• Heydenreich et al. (2020). The effects of varying depth in cosmic shear surveys. A&A, 634, A104.

Contributing to Salmo

No upcoming development is planned by the owner. Only maintenance will be done. However, developers are welcome to contribute to Salmo in various ways:

• draft an issue,
• e-mail to the owner at calin(at)roe.ac.uk,
• propose a pull request from a fork of this repository, or
• request for being a collaborator.

License

Salmo is released under GNU General Public License Version 3 (GPLv3).

It contains 2 pieces of code (this and that) taken from HEALPix and is released under GNU General Public License Version 2 (GPLv2).

This gives users the option to distribute an application which uses Salmo under the same GPLv3 license.

salmo's Issues

Logo

Design a logo for Salmo.

Script for unitary test

I need to make a script for a unitary test.

Script for file preparation

Need to write an example script to

• run Class to get C_ell
• create n(z)
• create mask

Compilation issue

In source/HEALPixFunctions.h, #include <chealpix.h>, should be "chealpix.h" so the compiler can find the local file in source.

Visualization scripts

Make a script to visualize the results.

Documentation in Wiki

I have created the architecture for the Wiki page. Now need to complete all pages.

Example wrapper script for executing Flask & Salmo

I want to polish my "pipeline" script which executes Flask & Salmo together and release it.

The script will take only one variable which is run_id. All files I/O can be handled accordingly.