Metadata-Version: 2.1
Name: powerbox
Version: 0.8.0
Summary: Create arbitrary boxes with isotropic power spectra
Author-email: Steven Murray <steven.g.murray@asu.edu>
License: MIT
Project-URL: repository, https://github.com/steven-murray/powerbox
Project-URL: documentation, https://powerbox.readthedocs.io
Keywords: power-spectrum,signal processing
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Description-Content-Type: text/x-rst
License-File: LICENSE.rst
Requires-Dist: numpy>1.6.2
Provides-Extra: tests
Requires-Dist: wheel; extra == "tests"
Requires-Dist: flake8; extra == "tests"
Requires-Dist: pytest; extra == "tests"
Requires-Dist: pytest-cov; extra == "tests"
Requires-Dist: scipy; extra == "tests"
Provides-Extra: docs
Requires-Dist: sphinx; extra == "docs"
Requires-Dist: numpydoc; extra == "docs"
Requires-Dist: nbsphinx; extra == "docs"
Requires-Dist: ipykernel; extra == "docs"
Requires-Dist: pandoc; extra == "docs"
Requires-Dist: sphinx_rtd_theme; extra == "docs"
Requires-Dist: sphinx-automodapi==0.7; extra == "docs"
Requires-Dist: matplotlib; extra == "docs"
Requires-Dist: hmf; extra == "docs"
Requires-Dist: packaging; extra == "docs"
Provides-Extra: dev
Requires-Dist: powerbox[docs,fftw,tests]; extra == "dev"
Requires-Dist: pre-commit; extra == "dev"
Provides-Extra: fftw
Requires-Dist: pyfftw; extra == "fftw"
Provides-Extra: all
Requires-Dist: powerbox[dev]; extra == "all"

========
powerbox
========
.. image:: https://img.shields.io/pypi/v/powerbox.svg
    :target: https://pypi.python.org/pypi/powerbox
.. image:: https://travis-ci.org/steven-murray/powerbox.svg?branch=master
    :target: https://travis-ci.org/steven-murray/powerbox
.. image:: https://coveralls.io/repos/github/steven-murray/powerbox/badge.svg?branch=master
    :target: https://coveralls.io/github/steven-murray/powerbox?branch=master
.. image:: https://api.codacy.com/project/badge/Grade/5853411c78444a5a9c6ec4058c6dbda9
    :target: https://www.codacy.com/app/steven-murray/powerbox?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=steven-murray/powerbox&amp;utm_campaign=Badge_Grade
.. image:: https://zenodo.org/badge/72076717.svg
   :target: https://zenodo.org/badge/latestdoi/72076717
.. image:: http://joss.theoj.org/papers/10.21105/joss.00850/status.svg
   :target: https://doi.org/10.21105/joss.00850

**Make arbitrarily structured, arbitrary-dimension boxes and log-normal mocks.**

``powerbox`` is a pure-python code for creating density grids (or boxes) that have an
arbitrary two-point distribution (i.e. power spectrum). Primary motivations for creating
the code were the simple creation of log-normal mock galaxy distributions, but the
methodology can be used for other applications.

Features
--------
* Works in any number of dimensions.
* Really simple.
* Arbitrary isotropic power-spectra.
* Create Gaussian or Log-Normal fields
* Create discrete samples following the field, assuming it describes an over-density.
* Measure power spectra of output fields to ensure consistency.
* Seamlessly uses pyFFTW if available for ~double the speed.

Installation
------------
Simply ``pip install powerbox``. If you want ~2x speedup for large boxes, you can also
install ``pyfftw`` by doing ``pip install powerbox[all]``. If you are a conda user, you
may want to install ``numpy`` with conda first. If you want to develop ``powerbox``,
clone the repo and install with ``python -m pip install -e ".[dev]"``.

Acknowledgment
--------------
If you find ``powerbox`` useful in your research, please cite the Journal of Open Source Software paper at
https://doi.org/10.21105/joss.00850.

QuickLinks
----------
* Docs: https://powerbox.readthedocs.io
* Quickstart: http://powerbox.readthedocs.io/en/latest/demos/getting_started.html
