[](https://www.python.org/)
[](https://circleci.com/gh/insarlab/PyAPS)
[](https://anaconda.org/conda-forge/pyaps3)
[](https://github.com/insarlab/PyAPS/releases)
[](https://github.com/insarlab/PyAPS/blob/main/LICENSE)
[](https://doi.org/10.1029/2011GL048757)
## PyAPS - Python based Atmospheric Phase Screen estimation
This Python 3 module estimates differential phase delay maps due to the stratified atmosphere for correcting radar interferograms. It is rewritten in Python 3 language from PyAPS source code and adapted for ECMWF's ERA-5 corrections.
WARNING: The current version does not work with NARR and MERRA datasets. Contributions are welcomed.
This is research code provided to you "as is" with NO WARRANTIES OF CORRECTNESS. Use at your own risk.
### 1. Installation
#### a. Install the released version [recommended]
`pyaps3` is available on the [conda-forge](https://anaconda.org/conda-forge/pyaps3) channel, [PyPI](https://pypi.org/project/pyaps3/) and the main archive of the [Debian](https://tracker.debian.org/pkg/pyaps3) GNU/Linux OS. The released version can be installed via `conda` as:
```bash
conda install -c conda-forge pyaps3
```
or via `pip` as:
```bash
pip install pyaps3
```
or via `apt` (or other package managers) for [Debian-derivative OS](https://wiki.debian.org/Derivatives/Census) users, including [Ubuntu](https://ubuntu.com), as:
```bash
apt install python3-pyaps3
```
#### b. Install the development version
The development version can be installed via `pip` as:
```bash
pip install git+https://github.com/insarlab/PyAPS.git
```
or build from source manually as:
```bash
git clone https://github.com/insarlab/PyAPS.git
conda install -c conda-forge --file PyAPS/requirements.txt
python -m pip install -e PyAPS
```
Test the installation by running:
```bash
python PyAPS/tests/test_calc.py
```
### 2. Account setup for [ERA5](https://www.ecmwf.int/en/forecasts/dataset/ecmwf-reanalysis-v5)
ERA5 data set is redistributed over the Copernicus Climate Data Store (CDS)-beta ([migration guide](https://confluence.ecmwf.int/display/CKB/Please+read%3A+CDS+and+ADS+migrating+to+new+infrastructure%3A+Common+Data+Store+%28CDS%29+Engine)). Registration is required for the data access and downloading.
+ [Create a new account](https://cds-beta.climate.copernicus.eu/) on the CDS-beta website if you don't own a user account yet. Note: the old CDS account won't work.
+ [CDS API setup](https://cds-beta.climate.copernicus.eu/how-to-api#install-the-cds-api-client): Create the local file `$HOME/.cdsapirc` (in your Unix/Linux environment) and add the following two lines:
```shell
url: https://cds-beta.climate.copernicus.eu/api
key: your-personal-access-token
```
Your Personal Access Token can be found under [Your profile > Personal Access Token](https://cds-beta.climate.copernicus.eu/profile) section or on the [setup guide](https://cds-beta.climate.copernicus.eu/how-to-api#install-the-cds-api-client) page. Alternatively, you could add the token to the `[CDS]` section in `model.cfg` file in the package directory, `site-packages/pyaps3` if installed via conda. Note: using your [old CDS API key](https://cds.climate.copernicus.eu/) will lead to a 401 Client Error and Authentication failed.
+ **Make sure** that you accept the data license in the Terms of use on ECMWF website: Login, under [Datasets > ERA5 hourly data on pressure levels from 1940 to present > Download > Terms of use](https://cds-beta.climate.copernicus.eu/datasets/reanalysis-era5-pressure-levels?tab=download), click **Accept** to accespt the license to use Copernicus Products.
+ Test the account setup by running:
```bash
git clone https://github.com/insarlab/PyAPS.git --depth 1
python PyAPS/tests/test_dload.py
```
### 3. Citing this work
The methodology and validation can be found in:
+ Jolivet, R., R. Grandin, C. Lasserre, M.-P. Doin and G. Peltzer (2011), Systematic InSAR tropospheric phase delay corrections from global meteorological reanalysis data, _Geophys. Res. Lett., 38,_ L17311, doi:[10.1029/2011GL048757](https://doi.org/10.1029/2011GL048757).
Raw data
{
"_id": null,
"home_page": null,
"name": "pyaps3",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "InSAR, troposphere, geodesy, geophysics, ERA5",
"author": "Angelique Benoit",
"author_email": "Romain Jolivet <insar@geologie.ens.fr>",
"download_url": "https://files.pythonhosted.org/packages/d1/89/8a27338722891b822d5a638c0aab6ec532b5cd5aadf1f49ccf27cbc39cff/pyaps3-0.3.5.tar.gz",
"platform": null,
"description": "[](https://www.python.org/)\n[](https://circleci.com/gh/insarlab/PyAPS)\n[](https://anaconda.org/conda-forge/pyaps3)\n[](https://github.com/insarlab/PyAPS/releases)\n[](https://github.com/insarlab/PyAPS/blob/main/LICENSE)\n[](https://doi.org/10.1029/2011GL048757)\n\n## PyAPS - Python based Atmospheric Phase Screen estimation\n\nThis Python 3 module estimates differential phase delay maps due to the stratified atmosphere for correcting radar interferograms. It is rewritten in Python 3 language from PyAPS source code and adapted for ECMWF's ERA-5 corrections.\n\nWARNING: The current version does not work with NARR and MERRA datasets. Contributions are welcomed.\n\nThis is research code provided to you \"as is\" with NO WARRANTIES OF CORRECTNESS. Use at your own risk.\n\n### 1. Installation\n\n#### a. Install the released version [recommended]\n\n`pyaps3` is available on the [conda-forge](https://anaconda.org/conda-forge/pyaps3) channel, [PyPI](https://pypi.org/project/pyaps3/) and the main archive of the [Debian](https://tracker.debian.org/pkg/pyaps3) GNU/Linux OS. The released version can be installed via `conda` as:\n\n```bash\nconda install -c conda-forge pyaps3\n```\n\nor via `pip` as:\n\n```bash\npip install pyaps3\n```\n\nor via `apt` (or other package managers) for [Debian-derivative OS](https://wiki.debian.org/Derivatives/Census) users, including [Ubuntu](https://ubuntu.com), as:\n\n```bash\napt install python3-pyaps3\n```\n\n#### b. Install the development version\n\nThe development version can be installed via `pip` as:\n\n```bash\npip install git+https://github.com/insarlab/PyAPS.git\n```\n\nor build from source manually as:\n\n```bash\ngit clone https://github.com/insarlab/PyAPS.git\nconda install -c conda-forge --file PyAPS/requirements.txt\npython -m pip install -e PyAPS\n```\n\nTest the installation by running:\n\n```bash\npython PyAPS/tests/test_calc.py\n```\n\n### 2. Account setup for [ERA5](https://www.ecmwf.int/en/forecasts/dataset/ecmwf-reanalysis-v5)\n\nERA5 data set is redistributed over the Copernicus Climate Data Store (CDS)-beta ([migration guide](https://confluence.ecmwf.int/display/CKB/Please+read%3A+CDS+and+ADS+migrating+to+new+infrastructure%3A+Common+Data+Store+%28CDS%29+Engine)). Registration is required for the data access and downloading.\n\n+ [Create a new account](https://cds-beta.climate.copernicus.eu/) on the CDS-beta website if you don't own a user account yet. Note: the old CDS account won't work.\n+ [CDS API setup](https://cds-beta.climate.copernicus.eu/how-to-api#install-the-cds-api-client): Create the local file `$HOME/.cdsapirc` (in your Unix/Linux environment) and add the following two lines:\n\n```shell\nurl: https://cds-beta.climate.copernicus.eu/api\nkey: your-personal-access-token\n```\n\nYour Personal Access Token can be found under [Your profile > Personal Access Token](https://cds-beta.climate.copernicus.eu/profile) section or on the [setup guide](https://cds-beta.climate.copernicus.eu/how-to-api#install-the-cds-api-client) page. Alternatively, you could add the token to the `[CDS]` section in `model.cfg` file in the package directory, `site-packages/pyaps3` if installed via conda. Note: using your [old CDS API key](https://cds.climate.copernicus.eu/) will lead to a 401 Client Error and Authentication failed.\n\n+ **Make sure** that you accept the data license in the Terms of use on ECMWF website: Login, under [Datasets > ERA5 hourly data on pressure levels from 1940 to present > Download > Terms of use](https://cds-beta.climate.copernicus.eu/datasets/reanalysis-era5-pressure-levels?tab=download), click **Accept** to accespt the license to use Copernicus Products.\n\n+ Test the account setup by running:\n\n```bash\ngit clone https://github.com/insarlab/PyAPS.git --depth 1\npython PyAPS/tests/test_dload.py\n```\n\n### 3. Citing this work\n\nThe methodology and validation can be found in:\n\n+ Jolivet, R., R. Grandin, C. Lasserre, M.-P. Doin and G. Peltzer (2011), Systematic InSAR tropospheric phase delay corrections from global meteorological reanalysis data, _Geophys. Res. Lett., 38,_ L17311, doi:[10.1029/2011GL048757](https://doi.org/10.1029/2011GL048757).\n",
"bugtrack_url": null,
"license": "GPL-3.0-or-later",
"summary": "Python based Atmospheric Phase Screen estimation",
"version": "0.3.5",
"project_urls": {
"Homepage": "https://github.com/insarlab/PyAPS",
"Issues": "https://github.com/insarlab/PyAPS/issues"
},
"split_keywords": [
"insar",
" troposphere",
" geodesy",
" geophysics",
" era5"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b6ac382990c629795f2b54a88fc4274a997b2b43b77f5246c129f6151dcaf74f",
"md5": "2351dcd2c438b139dcaed8bd3266bb97",
"sha256": "8d249bac5efcb82db1856d8633156f86d6b4b4aa2cf2737b10468386d4f2bacb"
},
"downloads": -1,
"filename": "pyaps3-0.3.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2351dcd2c438b139dcaed8bd3266bb97",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 55192,
"upload_time": "2024-09-18T16:34:47",
"upload_time_iso_8601": "2024-09-18T16:34:47.883716Z",
"url": "https://files.pythonhosted.org/packages/b6/ac/382990c629795f2b54a88fc4274a997b2b43b77f5246c129f6151dcaf74f/pyaps3-0.3.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d1898a27338722891b822d5a638c0aab6ec532b5cd5aadf1f49ccf27cbc39cff",
"md5": "9fac3787344dafe232f7db15c68245cc",
"sha256": "201fc0ca8c60de68015c031da179040c3709a8d3540f14ae453baba170aca82e"
},
"downloads": -1,
"filename": "pyaps3-0.3.5.tar.gz",
"has_sig": false,
"md5_digest": "9fac3787344dafe232f7db15c68245cc",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 4343394,
"upload_time": "2024-09-18T16:34:49",
"upload_time_iso_8601": "2024-09-18T16:34:49.893161Z",
"url": "https://files.pythonhosted.org/packages/d1/89/8a27338722891b822d5a638c0aab6ec532b5cd5aadf1f49ccf27cbc39cff/pyaps3-0.3.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-18 16:34:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "insarlab",
"github_project": "PyAPS",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"circle": true,
"requirements": [
{
"name": "cdsapi",
"specs": [
[
">=",
"0.7.0"
]
]
},
{
"name": "numpy",
"specs": []
},
{
"name": "pygrib",
"specs": []
},
{
"name": "scipy",
"specs": []
},
{
"name": "urllib3",
"specs": []
}
],
"lcname": "pyaps3"
}
JSON
