Scattering based cosmic string emulation

stringgen is a tool for creating emulations of cosmic string maps with statistics similar to those of a single (or small ensemble) of reference simulations. It uses wavelet phase harmonics to calculate a compressed representation of these reference simulations, which may then be used to synthesize new realisations with accurate statistical properties, e.g. 2 and 3 point correlations, skewness, kurtosis, and Minkowski functionals.

Install from source 💻

One may install the code from source by cloning and installing manually:

git clone https://github.com/astro-informatics/stringgen.git
cd stringgen
bash build_stringgen.sh

Usage 🚀

To generate your own cosmic string maps stringgen is as simple follows:

from stringgen import CosmicStringEmulator

# Configure the emulator
emulator = CosmicStringEmulator(
        emulation_shape=(1024, 1024),   # Shape of image
        J=9,                        # Number of wavelet scales
        L=9                         # Number of directions
    )

# Load latent data-bank
features = emulator.get_features()

# Generate n_emulation=1 synthetic cosmic string maps
emulation = emulator.emulate(features, n_emulations=1)

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Matt Price 💻 👀 🤔

Matthijs Mars 💻 👀 🤔

Auggie Marignier 💻

Alessio Spurio Mancini 💻

Jason McEwen 💻 👀 🤔

Matthew Docherty 💻

Attribution 📚

Should this code be used in any way, we kindly request that the following article is referenced. A BibTeX entry for this reference may look like:

@article{price:stringgen, 
   author      = "Matthew A. Price, Matthijs Mars, Matthew M. Docherty, Alessio Spurio Mancini, Augustin Marignier, Jason. D. McEwen",
   title       = "Fast emulation of anisotropies induced in the cosmic microwave background by cosmic strings",
   year        = "2023",
   journal     = "The Open Journal of Astrophysics,
   doi         = "10.21105/astro.2307.04798",
   eprint      = "arXiv:2307.04798"        
}

License 📝

We provide this code under an MIT open-source licence with the hope that it will be of use to a wider community.

Copyright 2023 Matthijs Mars, Matthew Price, Jason McEwen and contributors.

stringgen is free software made available under the MIT License. For details see the LICENSE file.