DanielaBreitman
commited on
Commit
•
66e531a
1
Parent(s):
9a35eae
Updated README.md
Browse files
README.md
CHANGED
@@ -1,3 +1,73 @@
|
|
1 |
-
|
2 |
-
|
3 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
+
# 21cmEMU
|
2 |
+
|
3 |
+
[![PyPI](https://img.shields.io/pypi/v/py21cmemu.svg)][pypi_]
|
4 |
+
[![Status](https://img.shields.io/pypi/status/py21cmemu.svg)][status]
|
5 |
+
[![Python Version](https://img.shields.io/pypi/pyversions/py21cmemu)][python version]
|
6 |
+
[![License](https://img.shields.io/pypi/l/py21cmemu)][license]
|
7 |
+
|
8 |
+
[![Read the documentation at https://21cmEMU.readthedocs.io/](https://img.shields.io/readthedocs/py21cmEMU/latest.svg?label=Read%20the%20Docs)][read the docs]
|
9 |
+
[![Tests](https://github.com/21cmFAST/21cmEMU/workflows/Tests/badge.svg)][tests]
|
10 |
+
[![Codecov](https://codecov.io/gh/21cmFAST/21cmEMU/branch/main/graph/badge.svg)][codecov]
|
11 |
+
|
12 |
+
[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)][pre-commit]
|
13 |
+
[![Black](https://img.shields.io/badge/code%20style-black-000000.svg)][black]
|
14 |
+
|
15 |
+
[pypi_]: https://pypi.org/project/py21cmemu/
|
16 |
+
[status]: https://pypi.org/project/py21cmemu/
|
17 |
+
[python version]: https://pypi.org/project/py21cmemu
|
18 |
+
[read the docs]: https://21cmemu.readthedocs.io/
|
19 |
+
[tests]: https://github.com/21cmFAST/21cmEMU/actions?workflow=Tests
|
20 |
+
[codecov]: https://app.codecov.io/gh/21cmFAST/21cmEMU
|
21 |
+
[pre-commit]: https://github.com/pre-commit/pre-commit
|
22 |
+
[black]: https://github.com/psf/black
|
23 |
+
|
24 |
+
## Features
|
25 |
+
|
26 |
+
- Uses Tensorflow to emulate the following summary statistics: 21-cm power spectrum, 21-cm global brightness temperature, IGM spin temperature, and neutral fraction.
|
27 |
+
- Uses 21cmFAST to analytically calculate the UV luminosity functions and the Thomson optical depth to the CMB.
|
28 |
+
|
29 |
+
## Requirements
|
30 |
+
|
31 |
+
- Tensorflow >= 2.6
|
32 |
+
- 21cmFAST
|
33 |
+
|
34 |
+
## Installation
|
35 |
+
|
36 |
+
You can install _py21cmEMU_ via [pip] from [PyPI]:
|
37 |
+
```console
|
38 |
+
$ pip install py21cmemu
|
39 |
+
```
|
40 |
+
## Usage
|
41 |
+
|
42 |
+
Please see the [Command-line Reference] for details.
|
43 |
+
|
44 |
+
## Contributing
|
45 |
+
|
46 |
+
Contributions are very welcome.
|
47 |
+
To learn more, see the [Contributor Guide].
|
48 |
+
|
49 |
+
## License
|
50 |
+
|
51 |
+
Distributed under the terms of the [MIT license][license],
|
52 |
+
_21cmEMU_ is free and open source software.
|
53 |
+
|
54 |
+
## Issues
|
55 |
+
|
56 |
+
If you encounter any problems,
|
57 |
+
please [file an issue] along with a detailed description.
|
58 |
+
|
59 |
+
## Credits
|
60 |
+
|
61 |
+
This project was generated from [@cjolowicz]'s [Hypermodern Python Cookiecutter] template.
|
62 |
+
|
63 |
+
[@cjolowicz]: https://github.com/cjolowicz
|
64 |
+
[pypi]: https://pypi.org/
|
65 |
+
[hypermodern python cookiecutter]: https://github.com/cjolowicz/cookiecutter-hypermodern-python
|
66 |
+
[file an issue]: https://github.com/21cmFAST/21cmEMU/issues
|
67 |
+
[pip]: https://pip.pypa.io/
|
68 |
+
|
69 |
+
<!-- github-only -->
|
70 |
+
|
71 |
+
[license]: https://github.com/21cmFAST/21cmEMU/blob/main/LICENSE
|
72 |
+
[contributor guide]: https://github.com/21cmFAST/21cmEMU/blob/main/CONTRIBUTING.md
|
73 |
+
[command-line reference]: https://21cmEMU.readthedocs.io/en/latest/usage.html
|