autoemulate 0.2.0__tar.gz → 0.3.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (82) hide show
  1. autoemulate-0.3.0/PKG-INFO +100 -0
  2. autoemulate-0.3.0/README.md +65 -0
  3. autoemulate-0.3.0/autoemulate/compare.py +1071 -0
  4. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/cross_validate.py +3 -0
  5. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/emulators/conditional_neural_process.py +4 -3
  6. autoemulate-0.3.0/autoemulate/experimental/compare.py +95 -0
  7. autoemulate-0.3.0/autoemulate/experimental/data/preprocessors.py +46 -0
  8. autoemulate-0.3.0/autoemulate/experimental/data/utils.py +176 -0
  9. autoemulate-0.3.0/autoemulate/experimental/data/validation.py +221 -0
  10. autoemulate-0.3.0/autoemulate/experimental/emulators/__init__.py +5 -0
  11. autoemulate-0.3.0/autoemulate/experimental/emulators/base.py +188 -0
  12. autoemulate-0.3.0/autoemulate/experimental/emulators/gaussian_process/__init__.py +14 -0
  13. autoemulate-0.3.0/autoemulate/experimental/emulators/gaussian_process/exact.py +216 -0
  14. autoemulate-0.3.0/autoemulate/experimental/emulators/lightgbm.py +138 -0
  15. autoemulate-0.3.0/autoemulate/experimental/emulators/neural_processes/conditional_neural_process.py +484 -0
  16. autoemulate-0.3.0/autoemulate/experimental/learners/__init__.py +36 -0
  17. autoemulate-0.3.0/autoemulate/experimental/learners/base.py +308 -0
  18. autoemulate-0.3.0/autoemulate/experimental/learners/membership.py +33 -0
  19. autoemulate-0.3.0/autoemulate/experimental/learners/pool.py +38 -0
  20. autoemulate-0.3.0/autoemulate/experimental/learners/stream.py +566 -0
  21. autoemulate-0.3.0/autoemulate/experimental/model_selection.py +116 -0
  22. autoemulate-0.3.0/autoemulate/experimental/simulations/__init__.py +0 -0
  23. autoemulate-0.3.0/autoemulate/experimental/tuner.py +79 -0
  24. autoemulate-0.3.0/autoemulate/experimental/types.py +20 -0
  25. autoemulate-0.3.0/autoemulate/history_matching.py +419 -0
  26. autoemulate-0.3.0/autoemulate/history_matching_dashboard.py +1241 -0
  27. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/hyperparam_searching.py +22 -5
  28. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/metrics.py +0 -1
  29. autoemulate-0.3.0/autoemulate/model_processing.py +101 -0
  30. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/plotting.py +72 -27
  31. autoemulate-0.3.0/autoemulate/preprocess_target.py +656 -0
  32. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/printing.py +38 -4
  33. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/sensitivity_analysis.py +49 -43
  34. autoemulate-0.3.0/autoemulate/simulations/__init__.py +0 -0
  35. autoemulate-0.3.0/autoemulate/simulations/base.py +205 -0
  36. autoemulate-0.3.0/autoemulate/simulations/circ_utils.py +233 -0
  37. autoemulate-0.3.0/autoemulate/simulations/flow_functions.py +162 -0
  38. autoemulate-0.3.0/autoemulate/simulations/naghavi_cardiac_ModularCirc.py +172 -0
  39. autoemulate-0.3.0/autoemulate/simulations/reaction_diffusion.py +129 -0
  40. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/utils.py +101 -3
  41. autoemulate-0.3.0/misc/AE_logo_final.png +0 -0
  42. autoemulate-0.3.0/pyproject.toml +109 -0
  43. autoemulate-0.2.0/PKG-INFO +0 -128
  44. autoemulate-0.2.0/README.md +0 -97
  45. autoemulate-0.2.0/autoemulate/compare.py +0 -625
  46. autoemulate-0.2.0/autoemulate/model_processing.py +0 -96
  47. autoemulate-0.2.0/misc/AE_logo_final.png +0 -0
  48. autoemulate-0.2.0/pyproject.toml +0 -65
  49. {autoemulate-0.2.0 → autoemulate-0.3.0}/LICENSE +0 -0
  50. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/__init__.py +0 -0
  51. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/data_splitting.py +0 -0
  52. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/datasets.py +0 -0
  53. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/emulators/__init__.py +0 -0
  54. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/emulators/conditional_neural_process_attn.py +0 -0
  55. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/emulators/gaussian_process.py +0 -0
  56. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/emulators/gaussian_process_mogp.py +0 -0
  57. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/emulators/gaussian_process_mt.py +0 -0
  58. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/emulators/gaussian_process_sklearn.py +0 -0
  59. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/emulators/gaussian_process_utils/__init__.py +0 -0
  60. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/emulators/gaussian_process_utils/early_stopping_criterion.py +0 -0
  61. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/emulators/gaussian_process_utils/poly_mean.py +0 -0
  62. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/emulators/gaussian_process_utils/polynomial_features.py +0 -0
  63. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/emulators/gradient_boosting.py +0 -0
  64. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/emulators/light_gbm.py +0 -0
  65. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/emulators/neural_net_sk.py +0 -0
  66. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/emulators/neural_networks/__init__.py +0 -0
  67. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/emulators/neural_networks/cnp_module.py +0 -0
  68. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/emulators/neural_networks/cnp_module_attn.py +0 -0
  69. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/emulators/neural_networks/datasets.py +0 -0
  70. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/emulators/neural_networks/gp_module.py +0 -0
  71. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/emulators/neural_networks/losses.py +0 -0
  72. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/emulators/polynomials.py +0 -0
  73. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/emulators/radial_basis_functions.py +0 -0
  74. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/emulators/random_forest.py +0 -0
  75. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/emulators/support_vector_machines.py +0 -0
  76. {autoemulate-0.2.0/autoemulate/simulations → autoemulate-0.3.0/autoemulate/experimental}/__init__.py +0 -0
  77. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/experimental_design.py +0 -0
  78. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/logging_config.py +0 -0
  79. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/model_registry.py +0 -0
  80. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/save.py +0 -0
  81. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/simulations/epidemic.py +0 -0
  82. {autoemulate-0.2.0 → autoemulate-0.3.0}/autoemulate/simulations/projectile.py +0 -0
@@ -0,0 +1,100 @@
1
+ Metadata-Version: 2.3
2
+ Name: autoemulate
3
+ Version: 0.3.0
4
+ Summary: A python package for semi-automated emulation
5
+ License: MIT
6
+ Author: AutoEmulate contributors (see our GitHub page)
7
+ Requires-Python: >=3.10,<3.13
8
+ Classifier: License :: OSI Approved :: MIT License
9
+ Classifier: Programming Language :: Python :: 3
10
+ Classifier: Programming Language :: Python :: 3.10
11
+ Classifier: Programming Language :: Python :: 3.11
12
+ Classifier: Programming Language :: Python :: 3.12
13
+ Provides-Extra: docs
14
+ Requires-Dist: anytree (>=2.12.1,<3.0.0)
15
+ Requires-Dist: gpytorch (>=1.12,<2.0)
16
+ Requires-Dist: iprogress (>=0.4,<0.5)
17
+ Requires-Dist: ipywidgets (>=8.1.2,<9.0.0)
18
+ Requires-Dist: joblib (>=1.3.2,<2.0.0)
19
+ Requires-Dist: lightgbm (>=4.3.0,<5.0.0)
20
+ Requires-Dist: matplotlib (>=3.7.2,<4.0.0)
21
+ Requires-Dist: mogp-emulator (>=0.7.2,<0.8.0)
22
+ Requires-Dist: numpy (>=1.24,<2.0)
23
+ Requires-Dist: pandas (>=2.1,<3.0)
24
+ Requires-Dist: salib (>=1.5.1,<2.0.0)
25
+ Requires-Dist: scikit-learn (>=1.3.0,<1.6.0)
26
+ Requires-Dist: scipy (>=1.11.3,<2.0.0)
27
+ Requires-Dist: seaborn (>=0.12.2,<0.13.0)
28
+ Requires-Dist: skorch (>=0.15.0,<0.16.0)
29
+ Requires-Dist: torch (>=2.1.0,<3.0.0)
30
+ Requires-Dist: torcheval (>=0.0.7,<0.0.8)
31
+ Requires-Dist: torchmetrics (>=1.7.1,<2.0.0)
32
+ Requires-Dist: tqdm (>=4.66.2,<5.0.0)
33
+ Description-Content-Type: text/markdown
34
+
35
+ # AutoEmulate <a href="https://alan-turing-institute.github.io/autoemulate/"><img src="misc/AE_logo_final.png" align="right" height="138" /></a>
36
+
37
+ ![CI](https://github.com/alan-turing-institute/autoemulate/actions/workflows/ci.yaml/badge.svg)
38
+ [![codecov](https://codecov.io/gh/alan-turing-institute/autoemulate/graph/badge.svg?token=XD1HXQUIGK)](https://codecov.io/gh/alan-turing-institute/autoemulate)
39
+ [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
40
+ [![All Contributors](https://img.shields.io/github/all-contributors/alan-turing-institute/autoemulate?color=ee8449&style=flat-square)](#contributors)
41
+ [![Documentation](https://img.shields.io/badge/documentation-blue)](https://alan-turing-institute.github.io/autoemulate/)
42
+
43
+ <!-- SPHINX-START -->
44
+ Simulations of physical systems are often slow and need lots of compute, which makes them unpractical for real-world applications like digital twins, or when they have to run thousands of times for sensitivity analyses. The goal of `AutoEmulate` is to make it easy to replace simulations with fast, accurate emulators. To do this, `AutoEmulate` automatically fits and compares various emulators, ranging from simple models like Radial Basis Functions and Second Order Polynomials to more complex models like Support Vector Machines, Gaussian Processes and Conditional Neural Processes to find the best emulator for a simulation.
45
+
46
+ ⚠️ Warning: This is an early version of the package and is still under development. We are working on improving the documentation and adding more features. If you have any questions or suggestions, please open an issue or a pull request.
47
+
48
+ ## Documentation
49
+
50
+ You can find the project documentation [here](https://alan-turing-institute.github.io/autoemulate/), including [installation](https://alan-turing-institute.github.io/autoemulate/getting-started/installation.html).
51
+
52
+ ## The AutoEmulate project
53
+
54
+ - The AutoEmulate project is run out of the [Alan Turing Institute](https://www.turing.ac.uk/).
55
+ - Visit [autoemulate.com](https://www.autoemulate.com/) to learn more.
56
+ - We have also published a paper in [The Journal of Open Source Software](https://joss.theoj.org/papers/10.21105/joss.07626).
57
+
58
+ Please cite this paper if you use the package in your work:
59
+
60
+ ```bibtex
61
+ @article{Stoffel2025, doi = {10.21105/joss.07626}, url = {https://doi.org/10.21105/joss.07626}, year = {2025}, publisher = {The Open Journal}, volume = {10}, number = {107}, pages = {7626}, author = {Martin A. Stoffel and Bryan M. Li and Kalle Westerling and Sophie Arana and Max Balmus and Eric Daub and Steve Niederer}, title = {AutoEmulate: A Python package for semi-automated emulation}, journal = {Journal of Open Source Software} }
62
+ ```
63
+
64
+ ## Contributors
65
+
66
+ <!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
67
+ <!-- prettier-ignore-start -->
68
+ <!-- markdownlint-disable -->
69
+ <table>
70
+ <tbody>
71
+ <tr>
72
+ <td align="center" valign="top" width="14.28%"><a href="http://www.westerling.nu"><img src="https://avatars.githubusercontent.com/u/7298727?v=4?s=100" width="100px;" alt="Kalle Westerling"/><br /><sub><b>Kalle Westerling</b></sub></a><br /><a href="#doc-kallewesterling" title="Documentation">📖</a> <a href="#code-kallewesterling" title="Code">💻</a> <a href="#content-kallewesterling" title="Content">🖋</a></td>
73
+ <td align="center" valign="top" width="14.28%"><a href="https://bryanli.io"><img src="https://avatars.githubusercontent.com/u/9648242?v=4?s=100" width="100px;" alt="Bryan M. Li"/><br /><sub><b>Bryan M. Li</b></sub></a><br /><a href="#code-bryanlimy" title="Code">💻</a></td>
74
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/mastoffel"><img src="https://avatars.githubusercontent.com/u/7348440?v=4?s=100" width="100px;" alt="martin"/><br /><sub><b>martin</b></sub></a><br /><a href="#code-mastoffel" title="Code">💻</a> <a href="#ideas-mastoffel" title="Ideas, Planning, & Feedback">🤔</a> <a href="#doc-mastoffel" title="Documentation">📖</a> <a href="#maintenance-mastoffel" title="Maintenance">🚧</a> <a href="#research-mastoffel" title="Research">🔬</a> <a href="#review-mastoffel" title="Reviewed Pull Requests">👀</a></td>
75
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/edaub"><img src="https://avatars.githubusercontent.com/u/45598892?v=4?s=100" width="100px;" alt="Eric Daub"/><br /><sub><b>Eric Daub</b></sub></a><br /><a href="#ideas-edaub" title="Ideas, Planning, & Feedback">🤔</a> <a href="#projectManagement-edaub" title="Project Management">📆</a> <a href="#review-edaub" title="Reviewed Pull Requests">👀</a> <a href="#code-edaub" title="Code">💻</a></td>
76
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/snie007"><img src="https://avatars.githubusercontent.com/u/20723650?v=4?s=100" width="100px;" alt="steven niederer"/><br /><sub><b>steven niederer</b></sub></a><br /><a href="#ideas-snie007" title="Ideas, Planning, & Feedback">🤔</a> <a href="#content-snie007" title="Content">🖋</a> <a href="#projectManagement-snie007" title="Project Management">📆</a></td>
77
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/MaxBalmus"><img src="https://avatars.githubusercontent.com/u/34339336?v=4?s=100" width="100px;" alt="Maximilian Balmus"/><br /><sub><b>Maximilian Balmus</b></sub></a><br /><a href="#code-MaxBalmus" title="Code">💻</a> <a href="#bug-MaxBalmus" title="Bug reports">🐛</a></td>
78
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/aranas"><img src="https://avatars.githubusercontent.com/u/6906140?v=4?s=100" width="100px;" alt="Sophie Arana"/><br /><sub><b>Sophie Arana</b></sub></a><br /><a href="#content-aranas" title="Content">🖋</a> <a href="#doc-aranas" title="Documentation">📖</a> <a href="#projectManagement-aranas" title="Project Management">📆</a></td>
79
+ </tr>
80
+ <tr>
81
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/aduncan001"><img src="https://avatars.githubusercontent.com/u/2352812?v=4?s=100" width="100px;" alt="Andrew Duncan"/><br /><sub><b>Andrew Duncan</b></sub></a><br /><a href="#ideas-aduncan001" title="Ideas, Planning, & Feedback">🤔</a> <a href="#projectManagement-aduncan001" title="Project Management">📆</a></td>
82
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/marjanfamili"><img src="https://avatars.githubusercontent.com/u/44607686?v=4?s=100" width="100px;" alt="Marjan Famili"/><br /><sub><b>Marjan Famili</b></sub></a><br /><a href="#code-marjanfamili" title="Code">💻</a> <a href="#ideas-marjanfamili" title="Ideas, Planning, & Feedback">🤔</a> <a href="#doc-marjanfamili" title="Documentation">📖</a> <a href="#review-marjanfamili" title="Reviewed Pull Requests">👀</a></td>
83
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/radka-j"><img src="https://avatars.githubusercontent.com/u/29207091?v=4?s=100" width="100px;" alt="Radka Jersakova"/><br /><sub><b>Radka Jersakova</b></sub></a><br /><a href="#code-radka-j" title="Code">💻</a> <a href="#projectManagement-radka-j" title="Project Management">📆</a> <a href="#maintenance-radka-j" title="Maintenance">🚧</a> <a href="#ideas-radka-j" title="Ideas, Planning, & Feedback">🤔</a></td>
84
+ <td align="center" valign="top" width="14.28%"><a href="https://cisprague.github.io/"><img src="https://avatars.githubusercontent.com/u/17131395?v=4?s=100" width="100px;" alt="Christopher Iliffe Sprague"/><br /><sub><b>Christopher Iliffe Sprague</b></sub></a><br /><a href="#code-cisprague" title="Code">💻</a> <a href="#design-cisprague" title="Design">🎨</a> <a href="#ideas-cisprague" title="Ideas, Planning, & Feedback">🤔</a> <a href="#review-cisprague" title="Reviewed Pull Requests">👀</a> <a href="#doc-cisprague" title="Documentation">📖</a></td>
85
+ <td align="center" valign="top" width="14.28%"><a href="https://www.energy.kth.se/energy-systems"><img src="https://avatars.githubusercontent.com/u/3727919?v=4?s=100" width="100px;" alt="Will Usher"/><br /><sub><b>Will Usher</b></sub></a><br /><a href="#code-willu47" title="Code">💻</a></td>
86
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/sgreenbury"><img src="https://avatars.githubusercontent.com/u/50113363?v=4?s=100" width="100px;" alt="Sam Greenbury"/><br /><sub><b>Sam Greenbury</b></sub></a><br /><a href="#code-sgreenbury" title="Code">💻</a> <a href="#ideas-sgreenbury" title="Ideas, Planning, & Feedback">🤔</a> <a href="#review-sgreenbury" title="Reviewed Pull Requests">👀</a> <a href="#projectManagement-sgreenbury" title="Project Management">📆</a></td>
87
+ <td align="center" valign="top" width="14.28%"><a href="https://edchalstrey.com/"><img src="https://avatars.githubusercontent.com/u/5486164?v=4?s=100" width="100px;" alt="Ed Chalstrey"/><br /><sub><b>Ed Chalstrey</b></sub></a><br /><a href="#code-edwardchalstrey1" title="Code">💻</a> <a href="#design-edwardchalstrey1" title="Design">🎨</a> <a href="#review-edwardchalstrey1" title="Reviewed Pull Requests">👀</a> <a href="#doc-edwardchalstrey1" title="Documentation">📖</a></td>
88
+ </tr>
89
+ <tr>
90
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/EdwinB12"><img src="https://avatars.githubusercontent.com/u/64434531?v=4?s=100" width="100px;" alt="Edwin "/><br /><sub><b>Edwin </b></sub></a><br /><a href="#code-EdwinB12" title="Code">💻</a> <a href="#ideas-EdwinB12" title="Ideas, Planning, & Feedback">🤔</a> <a href="#review-EdwinB12" title="Reviewed Pull Requests">👀</a></td>
91
+ <td align="center" valign="top" width="14.28%"><a href="https://paolo-conti.com/"><img src="https://avatars.githubusercontent.com/u/51111500?v=4?s=100" width="100px;" alt="Paolo Conti"/><br /><sub><b>Paolo Conti</b></sub></a><br /><a href="#code-ContiPaolo" title="Code">💻</a> <a href="#ideas-ContiPaolo" title="Ideas, Planning, & Feedback">🤔</a> <a href="#review-ContiPaolo" title="Reviewed Pull Requests">👀</a> <a href="#doc-ContiPaolo" title="Documentation">📖</a></td>
92
+ </tr>
93
+ </tbody>
94
+ </table>
95
+
96
+ <!-- markdownlint-restore -->
97
+ <!-- prettier-ignore-end -->
98
+
99
+ <!-- ALL-CONTRIBUTORS-LIST:END -->
100
+
@@ -0,0 +1,65 @@
1
+ # AutoEmulate <a href="https://alan-turing-institute.github.io/autoemulate/"><img src="misc/AE_logo_final.png" align="right" height="138" /></a>
2
+
3
+ ![CI](https://github.com/alan-turing-institute/autoemulate/actions/workflows/ci.yaml/badge.svg)
4
+ [![codecov](https://codecov.io/gh/alan-turing-institute/autoemulate/graph/badge.svg?token=XD1HXQUIGK)](https://codecov.io/gh/alan-turing-institute/autoemulate)
5
+ [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
6
+ [![All Contributors](https://img.shields.io/github/all-contributors/alan-turing-institute/autoemulate?color=ee8449&style=flat-square)](#contributors)
7
+ [![Documentation](https://img.shields.io/badge/documentation-blue)](https://alan-turing-institute.github.io/autoemulate/)
8
+
9
+ <!-- SPHINX-START -->
10
+ Simulations of physical systems are often slow and need lots of compute, which makes them unpractical for real-world applications like digital twins, or when they have to run thousands of times for sensitivity analyses. The goal of `AutoEmulate` is to make it easy to replace simulations with fast, accurate emulators. To do this, `AutoEmulate` automatically fits and compares various emulators, ranging from simple models like Radial Basis Functions and Second Order Polynomials to more complex models like Support Vector Machines, Gaussian Processes and Conditional Neural Processes to find the best emulator for a simulation.
11
+
12
+ ⚠️ Warning: This is an early version of the package and is still under development. We are working on improving the documentation and adding more features. If you have any questions or suggestions, please open an issue or a pull request.
13
+
14
+ ## Documentation
15
+
16
+ You can find the project documentation [here](https://alan-turing-institute.github.io/autoemulate/), including [installation](https://alan-turing-institute.github.io/autoemulate/getting-started/installation.html).
17
+
18
+ ## The AutoEmulate project
19
+
20
+ - The AutoEmulate project is run out of the [Alan Turing Institute](https://www.turing.ac.uk/).
21
+ - Visit [autoemulate.com](https://www.autoemulate.com/) to learn more.
22
+ - We have also published a paper in [The Journal of Open Source Software](https://joss.theoj.org/papers/10.21105/joss.07626).
23
+
24
+ Please cite this paper if you use the package in your work:
25
+
26
+ ```bibtex
27
+ @article{Stoffel2025, doi = {10.21105/joss.07626}, url = {https://doi.org/10.21105/joss.07626}, year = {2025}, publisher = {The Open Journal}, volume = {10}, number = {107}, pages = {7626}, author = {Martin A. Stoffel and Bryan M. Li and Kalle Westerling and Sophie Arana and Max Balmus and Eric Daub and Steve Niederer}, title = {AutoEmulate: A Python package for semi-automated emulation}, journal = {Journal of Open Source Software} }
28
+ ```
29
+
30
+ ## Contributors
31
+
32
+ <!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
33
+ <!-- prettier-ignore-start -->
34
+ <!-- markdownlint-disable -->
35
+ <table>
36
+ <tbody>
37
+ <tr>
38
+ <td align="center" valign="top" width="14.28%"><a href="http://www.westerling.nu"><img src="https://avatars.githubusercontent.com/u/7298727?v=4?s=100" width="100px;" alt="Kalle Westerling"/><br /><sub><b>Kalle Westerling</b></sub></a><br /><a href="#doc-kallewesterling" title="Documentation">📖</a> <a href="#code-kallewesterling" title="Code">💻</a> <a href="#content-kallewesterling" title="Content">🖋</a></td>
39
+ <td align="center" valign="top" width="14.28%"><a href="https://bryanli.io"><img src="https://avatars.githubusercontent.com/u/9648242?v=4?s=100" width="100px;" alt="Bryan M. Li"/><br /><sub><b>Bryan M. Li</b></sub></a><br /><a href="#code-bryanlimy" title="Code">💻</a></td>
40
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/mastoffel"><img src="https://avatars.githubusercontent.com/u/7348440?v=4?s=100" width="100px;" alt="martin"/><br /><sub><b>martin</b></sub></a><br /><a href="#code-mastoffel" title="Code">💻</a> <a href="#ideas-mastoffel" title="Ideas, Planning, & Feedback">🤔</a> <a href="#doc-mastoffel" title="Documentation">📖</a> <a href="#maintenance-mastoffel" title="Maintenance">🚧</a> <a href="#research-mastoffel" title="Research">🔬</a> <a href="#review-mastoffel" title="Reviewed Pull Requests">👀</a></td>
41
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/edaub"><img src="https://avatars.githubusercontent.com/u/45598892?v=4?s=100" width="100px;" alt="Eric Daub"/><br /><sub><b>Eric Daub</b></sub></a><br /><a href="#ideas-edaub" title="Ideas, Planning, & Feedback">🤔</a> <a href="#projectManagement-edaub" title="Project Management">📆</a> <a href="#review-edaub" title="Reviewed Pull Requests">👀</a> <a href="#code-edaub" title="Code">💻</a></td>
42
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/snie007"><img src="https://avatars.githubusercontent.com/u/20723650?v=4?s=100" width="100px;" alt="steven niederer"/><br /><sub><b>steven niederer</b></sub></a><br /><a href="#ideas-snie007" title="Ideas, Planning, & Feedback">🤔</a> <a href="#content-snie007" title="Content">🖋</a> <a href="#projectManagement-snie007" title="Project Management">📆</a></td>
43
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/MaxBalmus"><img src="https://avatars.githubusercontent.com/u/34339336?v=4?s=100" width="100px;" alt="Maximilian Balmus"/><br /><sub><b>Maximilian Balmus</b></sub></a><br /><a href="#code-MaxBalmus" title="Code">💻</a> <a href="#bug-MaxBalmus" title="Bug reports">🐛</a></td>
44
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/aranas"><img src="https://avatars.githubusercontent.com/u/6906140?v=4?s=100" width="100px;" alt="Sophie Arana"/><br /><sub><b>Sophie Arana</b></sub></a><br /><a href="#content-aranas" title="Content">🖋</a> <a href="#doc-aranas" title="Documentation">📖</a> <a href="#projectManagement-aranas" title="Project Management">📆</a></td>
45
+ </tr>
46
+ <tr>
47
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/aduncan001"><img src="https://avatars.githubusercontent.com/u/2352812?v=4?s=100" width="100px;" alt="Andrew Duncan"/><br /><sub><b>Andrew Duncan</b></sub></a><br /><a href="#ideas-aduncan001" title="Ideas, Planning, & Feedback">🤔</a> <a href="#projectManagement-aduncan001" title="Project Management">📆</a></td>
48
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/marjanfamili"><img src="https://avatars.githubusercontent.com/u/44607686?v=4?s=100" width="100px;" alt="Marjan Famili"/><br /><sub><b>Marjan Famili</b></sub></a><br /><a href="#code-marjanfamili" title="Code">💻</a> <a href="#ideas-marjanfamili" title="Ideas, Planning, & Feedback">🤔</a> <a href="#doc-marjanfamili" title="Documentation">📖</a> <a href="#review-marjanfamili" title="Reviewed Pull Requests">👀</a></td>
49
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/radka-j"><img src="https://avatars.githubusercontent.com/u/29207091?v=4?s=100" width="100px;" alt="Radka Jersakova"/><br /><sub><b>Radka Jersakova</b></sub></a><br /><a href="#code-radka-j" title="Code">💻</a> <a href="#projectManagement-radka-j" title="Project Management">📆</a> <a href="#maintenance-radka-j" title="Maintenance">🚧</a> <a href="#ideas-radka-j" title="Ideas, Planning, & Feedback">🤔</a></td>
50
+ <td align="center" valign="top" width="14.28%"><a href="https://cisprague.github.io/"><img src="https://avatars.githubusercontent.com/u/17131395?v=4?s=100" width="100px;" alt="Christopher Iliffe Sprague"/><br /><sub><b>Christopher Iliffe Sprague</b></sub></a><br /><a href="#code-cisprague" title="Code">💻</a> <a href="#design-cisprague" title="Design">🎨</a> <a href="#ideas-cisprague" title="Ideas, Planning, & Feedback">🤔</a> <a href="#review-cisprague" title="Reviewed Pull Requests">👀</a> <a href="#doc-cisprague" title="Documentation">📖</a></td>
51
+ <td align="center" valign="top" width="14.28%"><a href="https://www.energy.kth.se/energy-systems"><img src="https://avatars.githubusercontent.com/u/3727919?v=4?s=100" width="100px;" alt="Will Usher"/><br /><sub><b>Will Usher</b></sub></a><br /><a href="#code-willu47" title="Code">💻</a></td>
52
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/sgreenbury"><img src="https://avatars.githubusercontent.com/u/50113363?v=4?s=100" width="100px;" alt="Sam Greenbury"/><br /><sub><b>Sam Greenbury</b></sub></a><br /><a href="#code-sgreenbury" title="Code">💻</a> <a href="#ideas-sgreenbury" title="Ideas, Planning, & Feedback">🤔</a> <a href="#review-sgreenbury" title="Reviewed Pull Requests">👀</a> <a href="#projectManagement-sgreenbury" title="Project Management">📆</a></td>
53
+ <td align="center" valign="top" width="14.28%"><a href="https://edchalstrey.com/"><img src="https://avatars.githubusercontent.com/u/5486164?v=4?s=100" width="100px;" alt="Ed Chalstrey"/><br /><sub><b>Ed Chalstrey</b></sub></a><br /><a href="#code-edwardchalstrey1" title="Code">💻</a> <a href="#design-edwardchalstrey1" title="Design">🎨</a> <a href="#review-edwardchalstrey1" title="Reviewed Pull Requests">👀</a> <a href="#doc-edwardchalstrey1" title="Documentation">📖</a></td>
54
+ </tr>
55
+ <tr>
56
+ <td align="center" valign="top" width="14.28%"><a href="https://github.com/EdwinB12"><img src="https://avatars.githubusercontent.com/u/64434531?v=4?s=100" width="100px;" alt="Edwin "/><br /><sub><b>Edwin </b></sub></a><br /><a href="#code-EdwinB12" title="Code">💻</a> <a href="#ideas-EdwinB12" title="Ideas, Planning, & Feedback">🤔</a> <a href="#review-EdwinB12" title="Reviewed Pull Requests">👀</a></td>
57
+ <td align="center" valign="top" width="14.28%"><a href="https://paolo-conti.com/"><img src="https://avatars.githubusercontent.com/u/51111500?v=4?s=100" width="100px;" alt="Paolo Conti"/><br /><sub><b>Paolo Conti</b></sub></a><br /><a href="#code-ContiPaolo" title="Code">💻</a> <a href="#ideas-ContiPaolo" title="Ideas, Planning, & Feedback">🤔</a> <a href="#review-ContiPaolo" title="Reviewed Pull Requests">👀</a> <a href="#doc-ContiPaolo" title="Documentation">📖</a></td>
58
+ </tr>
59
+ </tbody>
60
+ </table>
61
+
62
+ <!-- markdownlint-restore -->
63
+ <!-- prettier-ignore-end -->
64
+
65
+ <!-- ALL-CONTRIBUTORS-LIST:END -->