title: The CosmoAI project
The CosmoSim software
This project provides a simulator for gravitational lensing based on Chris Clarkson's Roulettes framework. The code is experimental, and intended for research, with many loose ends. If you think it may be useful, we shall be happy to discuss collaboration and help you get started.
The core team is
- Dr. Ben David Normann - computer science and mathematics
- Hans Georg Schaathun - cosmology and mathematics Documentation is being written at https://cosmoai-aes.github.io/, but it still incomplete and fragmented.
Documentation is on the web site, The notes below is just a brief synopsis.
Installation Guide
CosmoSim is set up to build python packages (wheels) that can be installed with pip.
pip install CosmoSim
You can check the version installed with
python -m CosmoSim --version
Local build
We successfully build CosmoSim for Linux/x86_64, MacOS/arm, and Windows/amd64, for python 3.11 through 3.14 (the free-threaded 3.14t build is available on Linux and macOS).
To build locally from source, you can run (from the root of the repo),
pip install build
python -m build
This is highly dependent on the local configuration, and may fail for a number of reasons. If it succeeds, the binary file for the python module appears under src/CosmoSim.
If you can build, pip can also install the package from the working directory. Again, from the root of the repo,
pip install .
For non-standard building, see BUILD.md.
Running the GUI
python3 -m CosmoSim.GUI
The GUI tool is hopefully quite self-explanatory.
The images shown are the actual source on the left and the distorted (lensed)
image on the right.
The Command Line Interface (CLI)
An illustrative test set can be generated by the following command.
mkdir images
python3 -m CosmoSim -CR -Z 400 --csvfile Datasets/dataset.csv --directory images
This generates a range of images in the newly created images directory.
The flags may be changed; -C centres det distorted image in the centre
of the image (being debugged); -Z sets the image size; -R prints an
axes cross.
Further documentation and examples are found on the web site,
Versions
- The imortant git branches are
- develop is the current state of the art
- master should be the last stable version
- Releases
- v-test-* are test releases, used to debug workflows. Please ignore.
- see the releases on github and CHANGELOG.md
1 maintainer
Release files for CosmoSim 3.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cosmosim-3.3.0.tar.gz | 7.9 MB | Details |
Built distributions (wheels)
Total release size:97.6 MB
Release files / cosmosim-3.3.0.tar.gz
| Download URL | cosmosim-3.3.0.tar.gz |
|---|---|
| Size | 7.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
469dc4823e5711c3140f615b4f8cd58bcabb5fb6fb590cc66cd0ed831fe2c496
|
|
BLAKE2b-256 checksum How to use checksums |
f9ef80f1c95c2e37585abb34012ec80ed7826f8a748805219a34f5d76598cce1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 23, 2026.
Transparency logRelease files / cosmosim-3.3.0-cp314-cp314t-manylinux_2_28_x86_64.whl
| Download URL | cosmosim-3.3.0-cp314-cp314t-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 15.5 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
b1a6b1572fff9cb038cbdefbed24dc3fa913037113a5828410369c0f80d9f088
|
|
BLAKE2b-256 checksum How to use checksums |
9283c30e00488a4547be1f8e8a5dc1b6d1aec4196df729b49f524b86e674c652
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 23, 2026.
Transparency logRelease files / cosmosim-3.3.0-cp314-cp314t-macosx_11_0_arm64.whl
| Download URL | cosmosim-3.3.0-cp314-cp314t-macosx_11_0_arm64.whl |
|---|---|
| Size | 9.1 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
715647d8b5f03485c6e0e162ee287c2df2372a4e1eabadd965030fd88e73ee89
|
|
BLAKE2b-256 checksum How to use checksums |
28c32cac231eee2a9894c07029ad14511a03d8217fdc7bdb703134c516864f2d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 23, 2026.
Transparency logRelease files / cosmosim-3.3.0-cp314-cp314-win_amd64.whl
| Download URL | cosmosim-3.3.0-cp314-cp314-win_amd64.whl |
|---|---|
| Size | 3.9 MB |
| Tags | CPython 3.14 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
cf604b113e29f3bc4537c3d6ee66abd77555c63af33ecf87b5162319d1d264b0
|
|
BLAKE2b-256 checksum How to use checksums |
952d31a9182aa7df63d3f3e8beaa14a65ea2ba86466a6780d66b6ef659eeddf3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 23, 2026.
Transparency logRelease files / cosmosim-3.3.0-cp314-cp314-manylinux_2_28_x86_64.whl
| Download URL | cosmosim-3.3.0-cp314-cp314-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 7.9 MB |
| Tags | CPython 3.14 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
af2adfae7a996e69dc39d0a697f973c93109a2159d80e8fe9bcf320f439021d4
|
|
BLAKE2b-256 checksum How to use checksums |
6f50d389e29bf28b93243d1c61f110dd82e7ef4b392b64c0561c6fd3c5c2e59c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 23, 2026.
Transparency logRelease files / cosmosim-3.3.0-cp314-cp314-macosx_11_0_arm64.whl
| Download URL | cosmosim-3.3.0-cp314-cp314-macosx_11_0_arm64.whl |
|---|---|
| Size | 4.7 MB |
| Tags | CPython 3.14 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
2d9f490fae9d3295d9dbc513abf85c4ff53392fc6bebcbcc6e5363de4a80d776
|
|
BLAKE2b-256 checksum How to use checksums |
49580658e6c1ee9e3bbb1613544763f1185f96b9d9e04826eab629b06d2b09e8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 23, 2026.
Transparency logRelease files / cosmosim-3.3.0-cp313-cp313-win_amd64.whl
| Download URL | cosmosim-3.3.0-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 3.7 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
e542d9795b536ca309037e1945b78ae5edfed94b1aaacd1bc58fb4914c62e7fa
|
|
BLAKE2b-256 checksum How to use checksums |
3b91404afce4fae2175b7ecc8798f2978a501b852f24881a59f50e412d1b58af
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 23, 2026.
Transparency logRelease files / cosmosim-3.3.0-cp313-cp313-manylinux_2_28_x86_64.whl
| Download URL | cosmosim-3.3.0-cp313-cp313-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 7.9 MB |
| Tags | CPython 3.13 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
559f86eaab7c0c6bc2342606653d87cfeaf9f219adfd435e57fcad580928b6c5
|
|
BLAKE2b-256 checksum How to use checksums |
4949ffca7850f6b68908ddf3bd412866904a64db8a326a6d16eeb5ac95cc5b8b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 23, 2026.
Transparency logRelease files / cosmosim-3.3.0-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | cosmosim-3.3.0-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 4.7 MB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
1993e1b1d99b83229a676edd5b69d3e059971912691143bb9c03801a98d20ad2
|
|
BLAKE2b-256 checksum How to use checksums |
55b3042afcc87a2b647838256a7c0fcec49f97a9de8492ab99388a89247cb8f3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 23, 2026.
Transparency logRelease files / cosmosim-3.3.0-cp312-cp312-win_amd64.whl
| Download URL | cosmosim-3.3.0-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 3.7 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
2856ff543311411c40c61308e7af0e49f40c4b06ffe6c840d11cb992fd511832
|
|
BLAKE2b-256 checksum How to use checksums |
5a096945f37707c4a1827e97daba86b0fbe05db0af3fbcf27a77a927072b4249
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 23, 2026.
Transparency logRelease files / cosmosim-3.3.0-cp312-cp312-manylinux_2_28_x86_64.whl
| Download URL | cosmosim-3.3.0-cp312-cp312-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 7.9 MB |
| Tags | CPython 3.12 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
cc72844b63cdd3684717614fa3e74a65f3f3fb746faff82c9e0b19cbfded8321
|
|
BLAKE2b-256 checksum How to use checksums |
30f8d66fbbf207fdd8d5609f2f1bf13e3954caec6048c51422be5fee5354dfe4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 23, 2026.
Transparency logRelease files / cosmosim-3.3.0-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | cosmosim-3.3.0-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 4.7 MB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
f755d10f7c5391e8252467bd3614d9b5317fa14969b3119067a172b50df01e10
|
|
BLAKE2b-256 checksum How to use checksums |
b2abf60351985ae18929b54fd72b003211168a9713d803203398fc68d1c9f09c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 23, 2026.
Transparency logRelease files / cosmosim-3.3.0-cp311-cp311-win_amd64.whl
| Download URL | cosmosim-3.3.0-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 3.7 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
5d48c6a6c926a80c0b4e3f1d1c2983f72350b30c1c587e48c81a9d91511b8b5c
|
|
BLAKE2b-256 checksum How to use checksums |
4a964f02a43c73f93a04ffd9541503b0e292657d1bcec7ea6353912da6ac48dd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 23, 2026.
Transparency logRelease files / cosmosim-3.3.0-cp311-cp311-manylinux_2_28_x86_64.whl
| Download URL | cosmosim-3.3.0-cp311-cp311-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 7.9 MB |
| Tags | CPython 3.11 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
527f6a90ecf271b909040dd340e0c7b76677af8745584f9c730ee733c28fa2b9
|
|
BLAKE2b-256 checksum How to use checksums |
daea82b8c6490c14f513da509ccb0f11d0caafce30591558cf3f2db65295f1b2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 23, 2026.
Transparency logRelease files / cosmosim-3.3.0-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | cosmosim-3.3.0-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 4.7 MB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
e4da4482590a771d4d84358154bc9d47023e86e2f5f8da1e25a695dc4ff823b5
|
|
BLAKE2b-256 checksum How to use checksums |
69d06d8d7702edf3e0113caad8a44a61a6dd47368b980e203b37086b3ede72b8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 23, 2026.
Transparency log
