# s1swotcolocs
[](https://pypi.python.org/pypi/s1swotcolocs)
[](https://travis-ci.com/agrouaze/s1swotcolocs)
[](https://s1swotcolocs.readthedocs.io/en/latest/?version=latest)
[](https://pyup.io/repos/github/agrouaze/s1swotcolocs/)
Python lib to create co-locations between Sentinel-1 IW or EW images and SWOT KaRin swath.
- Free software: MIT license
- Documentation: [https://s1swotcolocs.readthedocs.io](https://s1swotcolocs.readthedocs.io).
# Features
---
- Find temporal and spatial co-locations between Sentinel-1 (S1) Level-1/Level-2 products and SWOT Level-3 (L3) SSH data.
- Process S1 IW (Interferometric Wide swath) and EW (Extra Wide swath) modes.
- Interface with CDSE (Copernicus Data Space Ecosystem) for S1 data discovery.
- Generate output defining co-located S1 and SWOT data segments.
- Configurable time delta for co-location criteria.
- Utility functions for geospatial operations and data handling relevant to S1 and SWOT.
# usage
```python
import s1swotcolocs
```
# alias
## creating meta-data colocation files
```bash
# to use the lib within a docker image
./coloc_SWOT_L3_with_S1_CDSE_TOPS_sequential_wrapper.py --startdate 20250616 --stopdate 20250616 --confpath src/s1swotcolocs/localconfig.yml
# to use the lib
coloc_SWOT_L3_with_S1_CDSE_TOPS_sequentiel --startmonth 20250616 --stopmonth 20250616 --confpath src/s1swotcolocs/localconfig.yml --outputdir /tmp/
```
## illustration of a co-location between SWOT KaRIn swath and Sentinel-1 IW swath
## illustration of a co-location between SWOT KaRIn reduced swath and Sentinel-1 IW swath
For triple co-location (KaRin ,SWOT-nadir, IW Level-2 WAV) purposes it oculd be important to limit the KarIn swath to the low incidence part of the swath.
Raw data
{
"_id": null,
"home_page": null,
"name": "s1swotcolocs",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "SAR, SWOT, colocations, sea-state",
"author": "Antoine Grouazel",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/21/08/e2d23a13b08ea43555eb0c67bed1fd236b275a259ff9eb57f5005612e12c/s1swotcolocs-2025.9.10.post1.tar.gz",
"platform": null,
"description": "# s1swotcolocs\n\n[](https://pypi.python.org/pypi/s1swotcolocs)\n[](https://travis-ci.com/agrouaze/s1swotcolocs)\n[](https://s1swotcolocs.readthedocs.io/en/latest/?version=latest)\n[](https://pyup.io/repos/github/agrouaze/s1swotcolocs/)\n\nPython lib to create co-locations between Sentinel-1 IW or EW images and SWOT KaRin swath.\n\n- Free software: MIT license\n- Documentation: [https://s1swotcolocs.readthedocs.io](https://s1swotcolocs.readthedocs.io).\n\n# Features\n\n---\n\n- Find temporal and spatial co-locations between Sentinel-1 (S1) Level-1/Level-2 products and SWOT Level-3 (L3) SSH data.\n- Process S1 IW (Interferometric Wide swath) and EW (Extra Wide swath) modes.\n- Interface with CDSE (Copernicus Data Space Ecosystem) for S1 data discovery.\n- Generate output defining co-located S1 and SWOT data segments.\n- Configurable time delta for co-location criteria.\n- Utility functions for geospatial operations and data handling relevant to S1 and SWOT.\n\n# usage\n\n```python\n import s1swotcolocs\n```\n\n# alias\n\n## creating meta-data colocation files\n\n```bash\n# to use the lib within a docker image\n./coloc_SWOT_L3_with_S1_CDSE_TOPS_sequential_wrapper.py --startdate 20250616 --stopdate 20250616 --confpath src/s1swotcolocs/localconfig.yml\n\n# to use the lib\ncoloc_SWOT_L3_with_S1_CDSE_TOPS_sequentiel --startmonth 20250616 --stopmonth 20250616 --confpath src/s1swotcolocs/localconfig.yml --outputdir /tmp/\n```\n\n## illustration of a co-location between SWOT KaRIn swath and Sentinel-1 IW swath\n\n\n\n## illustration of a co-location between SWOT KaRIn reduced swath and Sentinel-1 IW swath\n\nFor triple co-location (KaRin ,SWOT-nadir, IW Level-2 WAV) purposes it oculd be important to limit the KarIn swath to the low incidence part of the swath.\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python lib to create co-locations between Sentinel-1 IW or EW images and SWOT KaRin swath.",
"version": "2025.9.10.post1",
"project_urls": {
"bugs": "https://github.com/agrouaze/s1swotcolocs/issues",
"changelog": "https://github.com/agrouaze/s1swotcolocs/blob/master/changelog.md",
"homepage": "https://github.com/agrouaze/s1swotcolocs"
},
"split_keywords": [
"sar",
" swot",
" colocations",
" sea-state"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "b2da596b9d40b9e352c073bedf854f185b6b4620a980bef1d9668fef3c4df68c",
"md5": "46bf6685fc7a414c48d7ad462d1a12cd",
"sha256": "bf966938d16b7be656764300761da0996972a09c619179856821a058ce869b82"
},
"downloads": -1,
"filename": "s1swotcolocs-2025.9.10.post1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "46bf6685fc7a414c48d7ad462d1a12cd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 3428703,
"upload_time": "2025-09-10T13:46:47",
"upload_time_iso_8601": "2025-09-10T13:46:47.784338Z",
"url": "https://files.pythonhosted.org/packages/b2/da/596b9d40b9e352c073bedf854f185b6b4620a980bef1d9668fef3c4df68c/s1swotcolocs-2025.9.10.post1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "2108e2d23a13b08ea43555eb0c67bed1fd236b275a259ff9eb57f5005612e12c",
"md5": "15de4dd1110252eeb583609ea1df1d3b",
"sha256": "a0d5326d9309c81175f3d1ca2cae80c52e0f730c7fe0aa7cb4ab8d40dd85fcac"
},
"downloads": -1,
"filename": "s1swotcolocs-2025.9.10.post1.tar.gz",
"has_sig": false,
"md5_digest": "15de4dd1110252eeb583609ea1df1d3b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 3633813,
"upload_time": "2025-09-10T13:46:49",
"upload_time_iso_8601": "2025-09-10T13:46:49.411426Z",
"url": "https://files.pythonhosted.org/packages/21/08/e2d23a13b08ea43555eb0c67bed1fd236b275a259ff9eb57f5005612e12c/s1swotcolocs-2025.9.10.post1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-10 13:46:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "agrouaze",
"github_project": "s1swotcolocs",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "s1swotcolocs"
}
JSON
