# dLuxToliman
[](https://badge.fury.io/py/dLuxToliman)
[](LICENSE)
## Description
This repository/package contains pre-built ∂Lux models of the Toliman optical system, and pre-built parametrised ∂Lux source objects for Alpha Centauri.
[∂Lux](https://louisdesdoigts.github.io/dLux/) is an open-source differentiable optical modelling framework harnessing the structural isomorphism between optical systems and neural networks, giving forwards models of optical system as a _parametric neural network_.
∂Lux is built in [Zodiax](https://github.com/LouisDesdoigts/zodiax) which is an open-source object-oriented [Jax](https://github.com/google/jax) framework built as an extension of [Equinox](https://github.com/patrick-kidger/equinox) for scientific programming.
The primary goal of the Toliman mission is to discover Earth-sized exoplanets orbiting in Alpha Centauri, the closest star system to our own.
To achieve this, the mission will employ a novel telescope design that will be able to detect subtle changes in the positions of the Alpha Centauri binary pair.
These changes are caused by the gravitational reflex motion induced by an Earth-sized companion, and this cutting-edge technology will enable scientists to identify exoplanets too small to be detected by conventional telescopes.
Toliman utilises a binary phase diffraction pupil to grasp the expected microarcsecond-scale astrometric signal.
## Installation
`dLuxToliman` is pip-installable. To install the latest release, simply run:
```bash
pip install dLuxToliman
```
## Usage
A very basic example of how to use this package is as follows:
```python
# imports
import dLuxToliman as dlT
from matplotlib import pyplot as plt
osys = dlT.TolimanOpticalSystem(psf_npixels=128) # creating Toliman optical system
source = dlT.AlphaCen(n_wavels=3, separation=8, position_angle=30) # creating Alpha Centauri source
psf = osys.model(source) # running optical simulation
# plotting
plt.imshow(psf ** .5, cmap='inferno')
plt.title('Toliman $\sqrt{PSF}$')
plt.show()
```
## Contributors
[Max Charles](https://github.com/maxecharles), [Louis Desdoigts](https://github.com/LouisDesdoigts), [Benjamin Pope](https://github.com/benjaminpope), and [Peter Tuthill](https://github.com/ptuthill).
## License
This package is released under the BSD 3-Clause License. See the [LICENSE](LICENSE) file for more information.
## Support
If you encounter any problems or have any questions related to Toliman models, please raise an issue or contact me at `max.charles@sydney.edu.au`.
Raw data
{
"_id": null,
"home_page": "https://github.com/maxecharles/dLuxToliman",
"name": "dLuxToliman",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7,<4.0",
"maintainer_email": "",
"keywords": "",
"author": "Max Charles",
"author_email": "max.charles@sydney.edu.au",
"download_url": "https://files.pythonhosted.org/packages/d0/99/39e1a632d783972aee9d77113692cc9318da14d598aae768235e47a87986/dLuxToliman-0.3.0.tar.gz",
"platform": null,
"description": "# dLuxToliman\n\n[](https://badge.fury.io/py/dLuxToliman)\n[](LICENSE)\n\n\n\n## Description\nThis repository/package contains pre-built \u2202Lux models of the Toliman optical system, and pre-built parametrised \u2202Lux source objects for Alpha Centauri.\n\n[\u2202Lux](https://louisdesdoigts.github.io/dLux/) is an open-source differentiable optical modelling framework harnessing the structural isomorphism between optical systems and neural networks, giving forwards models of optical system as a _parametric neural network_.\n\u2202Lux is built in [Zodiax](https://github.com/LouisDesdoigts/zodiax) which is an open-source object-oriented [Jax](https://github.com/google/jax) framework built as an extension of [Equinox](https://github.com/patrick-kidger/equinox) for scientific programming.\n\nThe primary goal of the Toliman mission is to discover Earth-sized exoplanets orbiting in Alpha Centauri, the closest star system to our own.\nTo achieve this, the mission will employ a novel telescope design that will be able to detect subtle changes in the positions of the Alpha Centauri binary pair.\nThese changes are caused by the gravitational reflex motion induced by an Earth-sized companion, and this cutting-edge technology will enable scientists to identify exoplanets too small to be detected by conventional telescopes.\nToliman utilises a binary phase diffraction pupil to grasp the expected microarcsecond-scale astrometric signal.\n\n## Installation\n\n`dLuxToliman` is pip-installable. To install the latest release, simply run:\n\n```bash\npip install dLuxToliman\n```\n\n## Usage\n\nA very basic example of how to use this package is as follows:\n\n```python\n# imports\nimport dLuxToliman as dlT\nfrom matplotlib import pyplot as plt\n\nosys = dlT.TolimanOpticalSystem(psf_npixels=128) # creating Toliman optical system\nsource = dlT.AlphaCen(n_wavels=3, separation=8, position_angle=30) # creating Alpha Centauri source\npsf = osys.model(source) # running optical simulation\n\n# plotting\nplt.imshow(psf ** .5, cmap='inferno')\nplt.title('Toliman $\\sqrt{PSF}$')\nplt.show()\n```\n\n\n\n## Contributors\n[Max Charles](https://github.com/maxecharles), [Louis Desdoigts](https://github.com/LouisDesdoigts), [Benjamin Pope](https://github.com/benjaminpope), and [Peter Tuthill](https://github.com/ptuthill).\n\n## License\n\nThis package is released under the BSD 3-Clause License. See the [LICENSE](LICENSE) file for more information.\n\n## Support\n\nIf you encounter any problems or have any questions related to Toliman models, please raise an issue or contact me at `max.charles@sydney.edu.au`.\n",
"bugtrack_url": null,
"license": "",
"summary": "A repo to hold the canonical dLux Toliman models.",
"version": "0.3.0",
"project_urls": {
"Bug Tracker": "https://github.com/maxecharles/dLuxToliman/issues",
"Homepage": "https://github.com/maxecharles/dLuxToliman"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c5fa9336eaaf46b4037c704628677c37da72cd0b53b7caa57a2a85cb160e22fe",
"md5": "c037f6257a74c615a51bddd97ea5c70d",
"sha256": "7621a94b5c65fefa155c46638c37925047d9c59a2f189ca5deed0e4269554009"
},
"downloads": -1,
"filename": "dLuxToliman-0.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c037f6257a74c615a51bddd97ea5c70d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7,<4.0",
"size": 114190,
"upload_time": "2023-11-13T23:20:37",
"upload_time_iso_8601": "2023-11-13T23:20:37.186293Z",
"url": "https://files.pythonhosted.org/packages/c5/fa/9336eaaf46b4037c704628677c37da72cd0b53b7caa57a2a85cb160e22fe/dLuxToliman-0.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d09939e1a632d783972aee9d77113692cc9318da14d598aae768235e47a87986",
"md5": "700a4b43f99504127264cf0c5f81d801",
"sha256": "f5a7297a8e656ce211c24bd18feb2dba29256d8fd62e23a6bfe771fc47f75fb3"
},
"downloads": -1,
"filename": "dLuxToliman-0.3.0.tar.gz",
"has_sig": false,
"md5_digest": "700a4b43f99504127264cf0c5f81d801",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7,<4.0",
"size": 1933779,
"upload_time": "2023-11-13T23:20:39",
"upload_time_iso_8601": "2023-11-13T23:20:39.669064Z",
"url": "https://files.pythonhosted.org/packages/d0/99/39e1a632d783972aee9d77113692cc9318da14d598aae768235e47a87986/dLuxToliman-0.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-13 23:20:39",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "maxecharles",
"github_project": "dLuxToliman",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "dLux",
"specs": [
[
"==",
"0.14.*"
]
]
},
{
"name": "zodiax",
"specs": []
}
],
"lcname": "dluxtoliman"
}
JSON
