| Name | paos JSON |
| Version |
1.2.7
JSON |
| download |
| home_page | None |
| Summary | PAOS, the Physical Optics Simulator, is a fast, modern, and reliable Python package for Physical Optics studies. It implements Physical Optics Propagation in Fresnel approximation and paraxial ray tracing to analyze complex waveform propagation through both generic and off-axes optical systems. |
| upload_time | 2025-01-18 18:48:26 |
| maintainer | None |
| docs_url | None |
| author | Andrea Bocchieri |
| requires_python | <4.0,>=3.9 |
| license | BSD-3-Clause |
| keywords |
python
open-source
psf
gui
optics
wavefront
ray-tracing
fresnel
optics-simulation
paos
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# ``PAOS``
[](https://badge.fury.io/py/paos)
[](https://badge.fury.io/gh/arielmission-space%2FPAOS)
[](https://pepy.tech/project/paos)
[](https://opensource.org/licenses/BSD-3-Clause)
[](https://paos.readthedocs.io/en/latest/?badge=latest)
## Introduction
``PAOS``, the Physical Optics Simulator, is a fast, modern, and reliable Python package for Physical Optics studies.
It implements Physical Optics Propagation in Fresnel approximation and paraxial ray tracing to analyze complex waveform propagation through both generic and off-axes optical systems.
## Table of contents
- [``PAOS``](#paos)
- [Introduction](#introduction)
- [Table of contents](#table-of-contents)
- [How to install](#how-to-install)
- [Install from PyPI](#install-from-pypi)
- [Install from source code](#install-from-source-code)
- [Test your installation](#test-your-installation)
- [Documentation](#documentation)
- [Build the html documentation](#build-the-html-documentation)
- [Build the pdf documentation](#build-the-pdf-documentation)
- [How to contribute](#how-to-contribute)
- [How to cite](#how-to-cite)
## How to install
Instructions on how to install ``PAOS``.
### Install from PyPI
``PAOS`` is available on PyPI and can be installed via pip as
pip install paos
### Install from source code
``PAOS`` is compatible (tested) with Python 3.8, 3.9 and 3.10
To install from source, clone the [repository](https://github.com/arielmission-space/PAOS/) and move inside the directory.
Then use `pip` as
pip install .
#### Test your installation
Try importing ``PAOS`` as
python -c "import paos; print(paos.__version__)"
Or running ``PAOS`` itself with the `help` flag as
paos -h
Or the Graphical User Interface with the `help` flag as
paos_gui -h
If there are no errors then the installation was successful!
## Documentation
``PAOS`` comes with an extensive documentation, which can be built using Sphinx.
The documentation includes a tutorial, a user guide and a reference guide.
To build the documentation, install the needed packages first via `poetry`:
pip install poetry
poetry install --with docs
### Build the html documentation
To build the html documentation, move into the `docs` directory and run
make html
The documentation will be produced into the `build/html` directory inside `docs`.
Open `index.html` to read the documentation.
### Build the pdf documentation
To build the pdf, move into the `docs` directory and run
make latexpdf
The documentation will be produced into the `build/latex` directory inside `docs`.
Open `paos.pdf` to read the documentation.
The developers use `pdflatex`; if you have another compiler for LaTex, please refer to [sphinx documentation](https://www.sphinx-doc.org/en/master/usage/configuration.html#latex-options).
## How to contribute
You can contribute to ``PAOS`` by reporting bugs, suggesting new features, or contributing to the code itself.
If you wish to contribute to the code, please follow the steps described in the documentation under `Developer guide`.
## How to cite
Andrea Bocchieri, Lorenzo V. Mugnai, Enzo Pascale, “PAOS: a fast, modern, and reliable Python package for physical optics studies,” Proc. SPIE 13092, Space Telescopes and Instrumentation 2024: Optical, Infrared, and Millimeter Wave, 130924K (23 August 2024); https://doi.org/10.1117/12.3018333
Raw data
{
"_id": null,
"home_page": null,
"name": "paos",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.9",
"maintainer_email": null,
"keywords": "python, open-source, psf, gui, optics, wavefront, ray-tracing, fresnel, optics-simulation, paos",
"author": "Andrea Bocchieri",
"author_email": "andrea.bocchieri@uniroma1.it",
"download_url": "https://files.pythonhosted.org/packages/15/da/7dbce09e48ea3f5a624685043a0a44d6852e37b7cf11ee4c86bb1057d08a/paos-1.2.7.tar.gz",
"platform": null,
"description": "# ``PAOS``\n\n[](https://badge.fury.io/py/paos)\n[](https://badge.fury.io/gh/arielmission-space%2FPAOS)\n[](https://pepy.tech/project/paos)\n[](https://opensource.org/licenses/BSD-3-Clause)\n[](https://paos.readthedocs.io/en/latest/?badge=latest)\n\n## Introduction\n\n``PAOS``, the Physical Optics Simulator, is a fast, modern, and reliable Python package for Physical Optics studies.\n\nIt implements Physical Optics Propagation in Fresnel approximation and paraxial ray tracing to analyze complex waveform propagation through both generic and off-axes optical systems.\n\n## Table of contents\n\n- [``PAOS``](#paos)\n - [Introduction](#introduction)\n - [Table of contents](#table-of-contents)\n - [How to install](#how-to-install)\n - [Install from PyPI](#install-from-pypi)\n - [Install from source code](#install-from-source-code)\n - [Test your installation](#test-your-installation)\n - [Documentation](#documentation)\n - [Build the html documentation](#build-the-html-documentation)\n - [Build the pdf documentation](#build-the-pdf-documentation)\n - [How to contribute](#how-to-contribute)\n - [How to cite](#how-to-cite)\n\n## How to install\n\nInstructions on how to install ``PAOS``.\n\n### Install from PyPI\n\n``PAOS`` is available on PyPI and can be installed via pip as\n\n pip install paos\n\n### Install from source code\n\n``PAOS`` is compatible (tested) with Python 3.8, 3.9 and 3.10\n\nTo install from source, clone the [repository](https://github.com/arielmission-space/PAOS/) and move inside the directory.\n\nThen use `pip` as\n\n pip install .\n\n#### Test your installation\n\nTry importing ``PAOS`` as\n\n python -c \"import paos; print(paos.__version__)\"\n\nOr running ``PAOS`` itself with the `help` flag as\n\n paos -h\n\nOr the Graphical User Interface with the `help` flag as\n\n paos_gui -h\n\nIf there are no errors then the installation was successful!\n\n## Documentation\n\n``PAOS`` comes with an extensive documentation, which can be built using Sphinx.\nThe documentation includes a tutorial, a user guide and a reference guide.\n\nTo build the documentation, install the needed packages first via `poetry`:\n\n pip install poetry\n poetry install --with docs\n\n### Build the html documentation\n\nTo build the html documentation, move into the `docs` directory and run\n\n make html\n\nThe documentation will be produced into the `build/html` directory inside `docs`.\nOpen `index.html` to read the documentation.\n\n### Build the pdf documentation\n\nTo build the pdf, move into the `docs` directory and run\n\n make latexpdf\n\nThe documentation will be produced into the `build/latex` directory inside `docs`.\nOpen `paos.pdf` to read the documentation.\n\nThe developers use `pdflatex`; if you have another compiler for LaTex, please refer to [sphinx documentation](https://www.sphinx-doc.org/en/master/usage/configuration.html#latex-options).\n\n## How to contribute\n\nYou can contribute to ``PAOS`` by reporting bugs, suggesting new features, or contributing to the code itself.\nIf you wish to contribute to the code, please follow the steps described in the documentation under `Developer guide`.\n\n## How to cite\n\nAndrea Bocchieri, Lorenzo V. Mugnai, Enzo Pascale, \u201cPAOS: a fast, modern, and reliable Python package for physical optics studies,\u201d Proc. SPIE 13092, Space Telescopes and Instrumentation 2024: Optical, Infrared, and Millimeter Wave, 130924K (23 August 2024); https://doi.org/10.1117/12.3018333\n\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "PAOS, the Physical Optics Simulator, is a fast, modern, and reliable Python package for Physical Optics studies. It implements Physical Optics Propagation in Fresnel approximation and paraxial ray tracing to analyze complex waveform propagation through both generic and off-axes optical systems.",
"version": "1.2.7",
"project_urls": {
"Documentation": "https://paos.readthedocs.io/en/latest/",
"Homepage": "https://github.com/arielmission-space/PAOS",
"Repository": "https://github.com/arielmission-space/PAOS.git"
},
"split_keywords": [
"python",
" open-source",
" psf",
" gui",
" optics",
" wavefront",
" ray-tracing",
" fresnel",
" optics-simulation",
" paos"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "584349e3ed6c36cfc9cb7da7ff1646a4529efa7853a2035dc70e08e0c183ac5b",
"md5": "9e7dff06f01128222ca996120317e57c",
"sha256": "bf89b6e24b25a39bc678a06efda32c67aa8ee91f9f2fa7245e245c7acab90cbe"
},
"downloads": -1,
"filename": "paos-1.2.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9e7dff06f01128222ca996120317e57c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 184138,
"upload_time": "2025-01-18T18:48:24",
"upload_time_iso_8601": "2025-01-18T18:48:24.547593Z",
"url": "https://files.pythonhosted.org/packages/58/43/49e3ed6c36cfc9cb7da7ff1646a4529efa7853a2035dc70e08e0c183ac5b/paos-1.2.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "15da7dbce09e48ea3f5a624685043a0a44d6852e37b7cf11ee4c86bb1057d08a",
"md5": "9e838510eef43a864d3eddf709a94c10",
"sha256": "6ebb86bc073c2df55eaaad760cd955201d4899c59e515b32360470d5b593e29e"
},
"downloads": -1,
"filename": "paos-1.2.7.tar.gz",
"has_sig": false,
"md5_digest": "9e838510eef43a864d3eddf709a94c10",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 176841,
"upload_time": "2025-01-18T18:48:26",
"upload_time_iso_8601": "2025-01-18T18:48:26.859317Z",
"url": "https://files.pythonhosted.org/packages/15/da/7dbce09e48ea3f5a624685043a0a44d6852e37b7cf11ee4c86bb1057d08a/paos-1.2.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-18 18:48:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "arielmission-space",
"github_project": "PAOS",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "paos"
}
