| Name | pandorapsf JSON |
| Version |
0.4.1
JSON |
| download |
| home_page | None |
| Summary | None |
| upload_time | 2025-03-18 20:36:58 |
| maintainer | None |
| docs_url | None |
| author | Christina Hedges |
| requires_python | <3.13,>=3.9 |
| license | None |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<a href="https://github.com/pandoramission/pandora-psf/actions/workflows/black.yml"><img src="https://github.com/pandoramission/pandora-psf/workflows/black/badge.svg" alt="black status"/></a> <a href="https://github.com/pandoramission/pandora-psf/actions/workflows/flake8.yml"><img src="https://github.com/pandoramission/pandora-psf/workflows/flake8/badge.svg" alt="flake8 status"/></a> [](https://pandoramission.github.io/pandora-psf/)
[](https://pypi.org/project/pandorapsf/)
[](https://pypi.org/project/pandorapsf/)
# pandorapsf
This is a standalone tool for working with the NASA Pandora Mission PSF. This can be used to model the expected distribution of starlight on the detector.
## Installation
To install you can use
```sh
pip install pandorapsf --upgrade
```
You should update your package often, as we frequently put out new versions with updated Current Best Estimates, and some limited new functionality. Check your version number using
```python
import pandorapsf as ppsf
ppsf.__version__
```
## Configuration
`pandorapsf` has a configuration system. This determines where `pandorapsf` will expect your data to be stored.
Users can find where the configuration file is stored using
```python
from pandorapsf import CONFIGDIR
print(CONFIGDIR)
```
You can display your current configuration using
```python
from pandorapsf import display_config
display_config()
```
You can access particular configuration parameters using
You can display your current configuration, for example use the following to find the `data_dir` parameter.
```python
from pandorapsf import config
config["SETTINGS"]["data_dir"]
```
You can update the configuration either by updating the `config.ini` file in your `CONFIRDIR` or you can update them in your environment using `save_config`, e.g.
```python
from pandorapsf import save_config
config["SETTINGS"]["log_level"] = "INFO"
save_config(config)
```
If you want to reset back to defaults you can use
```python
from pandorapsf import reset_config
reset_config()
```
### Configuration Parameters
Below is a table of all the configuration parameters in `pandorapsf` and their current defaults
| (section, key) | Description |
|:------------------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------|
| ('SETTINGS', 'data_dir') | Where data will be stored for the package. This includes ~0.5Gb of PSF files which will be downloaded. |
| ('SETTINGS', 'log_level') | Default level for the logger. Change this to make the tool more or less verbose by default. |
| ('SETTINGS', 'vis_psf_download_location') | Where the visible channel PSF file is located online for download. |
| ('SETTINGS', 'nir_psf_download_location') | Where the NIR channel PSF file is located online for download. |
| ('SETTINGS', 'vis_psf_creation_date') | This is the string provided in the "CREATION" keyword of the PSF fits file header. This will be used to verify that the PSF file is the correct version. |
| ('SETTINGS', 'nir_psf_creation_date') | This is the string provided in the "CREATION" keyword of the PSF fits file header. This will be used to verify that the PSF file is the correct version. |
### Obtaining PSF files
When you install this tool you will additionally need to download the PSF grid online. This grid will be updated periodically as we improve our estimates of Pandora's performance. `pandorapsf` will download the files for you and put them in your configured data directory.
As we release new versions of `pandorapsf`, the default configuration will change to point to new PSF files that contain our new best estimates. Keep your `pandorapsf` version up to date to ensure you have the most recent changes.
## Dependencies
This tool depends on [`sparse3d`](https://github.com/christinahedges/sparse3d) which implements the sparse matrix maths needed to quickly model scenes.
Raw data
{
"_id": null,
"home_page": null,
"name": "pandorapsf",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.9",
"maintainer_email": null,
"keywords": null,
"author": "Christina Hedges",
"author_email": "christina.l.hedges@nasa.gov",
"download_url": "https://files.pythonhosted.org/packages/05/93/28bb10d65adcd7a098f2594f426a1abf2f509450a6f51709686e148ec9b0/pandorapsf-0.4.1.tar.gz",
"platform": null,
"description": "<a href=\"https://github.com/pandoramission/pandora-psf/actions/workflows/black.yml\"><img src=\"https://github.com/pandoramission/pandora-psf/workflows/black/badge.svg\" alt=\"black status\"/></a> <a href=\"https://github.com/pandoramission/pandora-psf/actions/workflows/flake8.yml\"><img src=\"https://github.com/pandoramission/pandora-psf/workflows/flake8/badge.svg\" alt=\"flake8 status\"/></a> [](https://pandoramission.github.io/pandora-psf/)\n[](https://pypi.org/project/pandorapsf/)\n[](https://pypi.org/project/pandorapsf/)\n\n# pandorapsf\n\nThis is a standalone tool for working with the NASA Pandora Mission PSF. This can be used to model the expected distribution of starlight on the detector.\n\n## Installation\n\nTo install you can use\n\n```sh\npip install pandorapsf --upgrade\n```\n\nYou should update your package often, as we frequently put out new versions with updated Current Best Estimates, and some limited new functionality. Check your version number using\n\n```python\nimport pandorapsf as ppsf\nppsf.__version__\n```\n\n## Configuration\n\n`pandorapsf` has a configuration system. This determines where `pandorapsf` will expect your data to be stored.\n\nUsers can find where the configuration file is stored using\n\n ```python\n from pandorapsf import CONFIGDIR\n print(CONFIGDIR)\n ```\n\nYou can display your current configuration using\n\n ```python\n from pandorapsf import display_config\n display_config()\n ```\n\nYou can access particular configuration parameters using\n\nYou can display your current configuration, for example use the following to find the `data_dir` parameter.\n\n ```python\n from pandorapsf import config\n config[\"SETTINGS\"][\"data_dir\"]\n ```\n\nYou can update the configuration either by updating the `config.ini` file in your `CONFIRDIR` or you can update them in your environment using `save_config`, e.g.\n\n ```python\n from pandorapsf import save_config\n config[\"SETTINGS\"][\"log_level\"] = \"INFO\"\n save_config(config)\n ```\n\nIf you want to reset back to defaults you can use\n\n ```python\n from pandorapsf import reset_config\n reset_config()\n ```\n\n### Configuration Parameters\n\nBelow is a table of all the configuration parameters in `pandorapsf` and their current defaults\n\n| (section, key) | Description |\n|:------------------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ('SETTINGS', 'data_dir') | Where data will be stored for the package. This includes ~0.5Gb of PSF files which will be downloaded. |\n| ('SETTINGS', 'log_level') | Default level for the logger. Change this to make the tool more or less verbose by default. |\n| ('SETTINGS', 'vis_psf_download_location') | Where the visible channel PSF file is located online for download. |\n| ('SETTINGS', 'nir_psf_download_location') | Where the NIR channel PSF file is located online for download. |\n| ('SETTINGS', 'vis_psf_creation_date') | This is the string provided in the \"CREATION\" keyword of the PSF fits file header. This will be used to verify that the PSF file is the correct version. |\n| ('SETTINGS', 'nir_psf_creation_date') | This is the string provided in the \"CREATION\" keyword of the PSF fits file header. This will be used to verify that the PSF file is the correct version. |\n\n### Obtaining PSF files\n\nWhen you install this tool you will additionally need to download the PSF grid online. This grid will be updated periodically as we improve our estimates of Pandora's performance. `pandorapsf` will download the files for you and put them in your configured data directory.\n\nAs we release new versions of `pandorapsf`, the default configuration will change to point to new PSF files that contain our new best estimates. Keep your `pandorapsf` version up to date to ensure you have the most recent changes.\n\n## Dependencies\n\nThis tool depends on [`sparse3d`](https://github.com/christinahedges/sparse3d) which implements the sparse matrix maths needed to quickly model scenes.\n",
"bugtrack_url": null,
"license": null,
"summary": null,
"version": "0.4.1",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c8ede380514825c7113e8821f9bda322cf2f65418cbd01b12d4e37e23f16f381",
"md5": "2ef8324baf8640fa965bb063787d398c",
"sha256": "db86838ca841eca92e047cc6d5a5a9f542f3607a688622d7d55e48e81426310b"
},
"downloads": -1,
"filename": "pandorapsf-0.4.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2ef8324baf8640fa965bb063787d398c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.9",
"size": 1969380,
"upload_time": "2025-03-18T20:36:56",
"upload_time_iso_8601": "2025-03-18T20:36:56.121096Z",
"url": "https://files.pythonhosted.org/packages/c8/ed/e380514825c7113e8821f9bda322cf2f65418cbd01b12d4e37e23f16f381/pandorapsf-0.4.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "059328bb10d65adcd7a098f2594f426a1abf2f509450a6f51709686e148ec9b0",
"md5": "090330554b0c76ec91980d197431f8aa",
"sha256": "0e6629b47d3b6038d605f29c0cf2c5ad641f99663ab85ead79084a3be5b229c9"
},
"downloads": -1,
"filename": "pandorapsf-0.4.1.tar.gz",
"has_sig": false,
"md5_digest": "090330554b0c76ec91980d197431f8aa",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.9",
"size": 1969639,
"upload_time": "2025-03-18T20:36:58",
"upload_time_iso_8601": "2025-03-18T20:36:58.068103Z",
"url": "https://files.pythonhosted.org/packages/05/93/28bb10d65adcd7a098f2594f426a1abf2f509450a6f51709686e148ec9b0/pandorapsf-0.4.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-03-18 20:36:58",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "pandorapsf"
}
