===============
pix2vec
===============
*Geospatial Vector Representation of Planetary Remote Sensing Hyperspectral Data*
---------------------------------
.. image:: https://img.shields.io/pypi/v/pix2vec.svg
:target: https://pypi.python.org/pypi/pix2vec
.. image:: https://readthedocs.org/projects/pix2vec/badge/?version=latest
:target: https://pix2vec.readthedocs.io/en/latest/?version=latest
:alt: Documentation Status
pix2vec: Vector Representation of Planetary Hyperspectral Data Cubes
* Free software: GNU General Public License v3
* Documentation: https://pix2vec.readthedocs.io.
Features
--------
* Produces a vector representation of the raster representation of HSI data 'cubes' generated by ISIS
Requirements
------------
* a relatively recent `Integrated Software for Imagers and Spectrometers (ISIS) <https://isis.astrogeology.usgs.gov>`_ installation and the `kalasiris <https://github.com/rbeyer/kalasiris>`_ module (which will be installed automatically).
Cite in your work
-------------------
Frigeri, A. and Hare, T. 2023. Geospatial Vector Representation of
Planetary Mapping Spectrometer Data. 6th Planetay Data Workshop, Flagstaff, Arizona 26-28th June 2023, Abstract #7088.::
@INPROCEEDINGS{FrigeriHare2023,
author = {{Frigeri}, A. and {Hare}, T.},
title = "{Geospatial Vector Representation of Planetary Mapping Spectrometer Data}",
booktitle = {6th Planetay Data Workshop},
year = 2023,
series = {LPI},
month = jun,
eid = {7088},
pages = {7088}
}
installation
------------
within a working ISIS environment, run::
pip install pix2vect
pix2vec in brief
-----------------
`pix2vect` requires spice-initialized ISIS cubes (see `spiceinit`).
Let's start with an hyperspectral cube from the The Moon Mineralogy Mapper (M3), the NASA spectrometer onboard Chandrayaan-1 mission to the Moon::
(ISIS) $ pix2vec -i -c M3G20090103T084105_V03_L1B.cub
pix2vect - 2023 Alessandro Frigeri - Istituto Nazionale di Astrofisica
Cube Type:M3 samples:304 lines:11739 file:M3G20090103T084105_V03_L1B.cub
now we create a vector GIS file representing the geometry of the sensor's pixel on the lunar surface::
pix2vec -c M3G20090103T084105_V03_L1B.cub -s 1,150 -l 3050,3200 -o M3G20090103T084105_V03_L1B_subset.gpkg
the vector file can then be loaded in your favorite GIS, and we can plot the file with a `PixelValue` greyscale:
.. image:: https://github.com/afrigeri/pix2vec/raw/main/docs/images/m3-PixelValue.png
:alt: M3-PixelValue
:width: 600
each ground pixel element holds information that can be accessed:
.. image:: https://github.com/afrigeri/pix2vec/raw/main/docs/images/m3-detail.png
:alt: M3-subcube
:width: 600
for each ground-projected pixel, you now have access to these fields::
Filename Sample Line PixelValue RightAscension Declination
PlanetocentricLatitude PlanetographicLatitude PositiveEast360Longitude
PositiveEast180Longitude PositiveWest360Longitude PositiveWest180Longitude
BodyFixedCoordinateX BodyFixedCoordinateY BodyFixedCoordinateZ LocalRadius
SampleResolution LineResolution SpacecraftPositionX SpacecraftPositionY
SpacecraftPositionZ SpacecraftAzimuth SlantDistance TargetCenterDistance
SubSpacecraftLatitude SubSpacecraftLongitude SpacecraftAltitude OffNadirAngle
SubSpacecraftGroundAzimuth SunPositionX SunPositionY SunPositionZ
SubSolarAzimuth SolarDistance SubSolarLatitude SubSolarLongitude
SubSolarGroundAzimuth Phase Incidence Emission NorthAzimuth EphemerisTime UTC
LocalSolarTime SolarLongitude LookDirectionBodyFixedX LookDirectionBodyFixedY
LookDirectionBodyFixedZ LookDirectionJ2000X LookDirectionJ2000Y
LookDirectionJ2000Z LookDirectionCameraX LookDirectionCameraY
LookDirectionCameraZ ObliqueDetectorResolution ObliquePixelResolution
ObliqueLineResolution ObliqueSampleResolution Error
Documentation
-------------
Documentation is available at https://pix2vec.readthedocs.io
=======
History
=======
0.1.3 (2023-07-08)
------------------
* fixed image link and typos in docs.
0.1.2 (2023-06-25)
------------------
* added complete support for Mars and Moon IAU spatial reference systems
* version presented at the 6th Planetary Data Workshop in Flagstaff, Arizona
0.1.1 (2023-06-23)
------------------
* added complete set of fields.
0.1.0 (2023-06-21)
------------------
* First release on PyPI.
Raw data
{
"_id": null,
"home_page": "https://github.com/afrigeri/pix2vec",
"name": "pix2vec",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "pix2vec",
"author": "Alessandro Frigeri",
"author_email": "alessandro.frigeri@inaf.it",
"download_url": "https://files.pythonhosted.org/packages/ca/81/dd20844e0621767bd3a0cd451bfef4ff65c3452d3dcf21b92143fab8795a/pix2vec-0.1.5.tar.gz",
"platform": null,
"description": "===============\npix2vec\n===============\n*Geospatial Vector Representation of Planetary Remote Sensing Hyperspectral Data*\n\n---------------------------------\n\n\n.. image:: https://img.shields.io/pypi/v/pix2vec.svg\n :target: https://pypi.python.org/pypi/pix2vec\n\n.. image:: https://readthedocs.org/projects/pix2vec/badge/?version=latest\n :target: https://pix2vec.readthedocs.io/en/latest/?version=latest\n :alt: Documentation Status\n\n\npix2vec: Vector Representation of Planetary Hyperspectral Data Cubes\n\n\n* Free software: GNU General Public License v3\n* Documentation: https://pix2vec.readthedocs.io.\n\n\nFeatures\n--------\n\n* Produces a vector representation of the raster representation of HSI data 'cubes' generated by ISIS\n\nRequirements\n------------\n\n* a relatively recent `Integrated Software for Imagers and Spectrometers (ISIS) <https://isis.astrogeology.usgs.gov>`_ installation and the `kalasiris <https://github.com/rbeyer/kalasiris>`_ module (which will be installed automatically).\n \nCite in your work\n-------------------\n\nFrigeri, A. and Hare, T. 2023. Geospatial Vector Representation of \nPlanetary Mapping Spectrometer Data. 6th Planetay Data Workshop, Flagstaff, Arizona 26-28th June 2023, Abstract #7088.::\n\n @INPROCEEDINGS{FrigeriHare2023,\n author = {{Frigeri}, A. and {Hare}, T.},\n title = \"{Geospatial Vector Representation of Planetary Mapping Spectrometer Data}\",\n booktitle = {6th Planetay Data Workshop},\n year = 2023,\n series = {LPI},\n month = jun,\n eid = {7088},\n pages = {7088}\n }\n\n\ninstallation\n------------\n\nwithin a working ISIS environment, run::\n\n pip install pix2vect\n\n\n\npix2vec in brief\n-----------------\n\n`pix2vect` requires spice-initialized ISIS cubes (see `spiceinit`). \n\nLet's start with an hyperspectral cube from the The Moon Mineralogy Mapper (M3), the NASA spectrometer onboard Chandrayaan-1 mission to the Moon::\n\n (ISIS) $ pix2vec -i -c M3G20090103T084105_V03_L1B.cub \n pix2vect - 2023 Alessandro Frigeri - Istituto Nazionale di Astrofisica\n Cube Type:M3 samples:304 lines:11739 file:M3G20090103T084105_V03_L1B.cub\n\nnow we create a vector GIS file representing the geometry of the sensor's pixel on the lunar surface::\n\n pix2vec -c M3G20090103T084105_V03_L1B.cub -s 1,150 -l 3050,3200 -o M3G20090103T084105_V03_L1B_subset.gpkg \n\nthe vector file can then be loaded in your favorite GIS, and we can plot the file with a `PixelValue` greyscale:\n\n.. image:: https://github.com/afrigeri/pix2vec/raw/main/docs/images/m3-PixelValue.png\n :alt: M3-PixelValue\n :width: 600\n\neach ground pixel element holds information that can be accessed:\n\n.. image:: https://github.com/afrigeri/pix2vec/raw/main/docs/images/m3-detail.png\n :alt: M3-subcube\n :width: 600\n\nfor each ground-projected pixel, you now have access to these fields::\n\n\tFilename Sample Line PixelValue RightAscension Declination \n\tPlanetocentricLatitude PlanetographicLatitude PositiveEast360Longitude \n\tPositiveEast180Longitude PositiveWest360Longitude PositiveWest180Longitude \n\tBodyFixedCoordinateX BodyFixedCoordinateY BodyFixedCoordinateZ LocalRadius \n\tSampleResolution LineResolution SpacecraftPositionX SpacecraftPositionY \n\tSpacecraftPositionZ SpacecraftAzimuth SlantDistance TargetCenterDistance \n\tSubSpacecraftLatitude SubSpacecraftLongitude SpacecraftAltitude OffNadirAngle \n\tSubSpacecraftGroundAzimuth SunPositionX SunPositionY SunPositionZ \n\tSubSolarAzimuth SolarDistance SubSolarLatitude SubSolarLongitude \n\tSubSolarGroundAzimuth Phase Incidence Emission NorthAzimuth EphemerisTime UTC \n\tLocalSolarTime SolarLongitude LookDirectionBodyFixedX LookDirectionBodyFixedY \n\tLookDirectionBodyFixedZ LookDirectionJ2000X LookDirectionJ2000Y \n\tLookDirectionJ2000Z LookDirectionCameraX LookDirectionCameraY \n\tLookDirectionCameraZ ObliqueDetectorResolution ObliquePixelResolution \n\tObliqueLineResolution ObliqueSampleResolution Error\n\n\nDocumentation\n-------------\n\nDocumentation is available at https://pix2vec.readthedocs.io\n\n\n\n=======\nHistory\n=======\n\n0.1.3 (2023-07-08)\n------------------\n\n* fixed image link and typos in docs.\n\n0.1.2 (2023-06-25)\n------------------\n\n* added complete support for Mars and Moon IAU spatial reference systems\n* version presented at the 6th Planetary Data Workshop in Flagstaff, Arizona\n\n0.1.1 (2023-06-23)\n------------------\n\n* added complete set of fields.\n\n0.1.0 (2023-06-21)\n------------------\n\n* First release on PyPI.\n",
"bugtrack_url": null,
"license": "GNU General Public License v3",
"summary": "pix2vec produces a vector representation of planetary mapping spectrometers hyperspectral and camera ISIS data cube",
"version": "0.1.5",
"project_urls": {
"Homepage": "https://github.com/afrigeri/pix2vec"
},
"split_keywords": [
"pix2vec"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "eb0b39820c5761750e84b392b5729a74ef071d1fdb0dccdf36a753be9a769eeb",
"md5": "5330c7cf5eae9d0a418c261340abdc9b",
"sha256": "f2d257618f01548f3af1ef77358591957eb4e550c7a02223cf9a8b5a1c204359"
},
"downloads": -1,
"filename": "pix2vec-0.1.5-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "5330c7cf5eae9d0a418c261340abdc9b",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.6",
"size": 8512,
"upload_time": "2023-08-01T17:02:28",
"upload_time_iso_8601": "2023-08-01T17:02:28.151246Z",
"url": "https://files.pythonhosted.org/packages/eb/0b/39820c5761750e84b392b5729a74ef071d1fdb0dccdf36a753be9a769eeb/pix2vec-0.1.5-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ca81dd20844e0621767bd3a0cd451bfef4ff65c3452d3dcf21b92143fab8795a",
"md5": "88d4222ce0022adc7a2c1e52209d4fe4",
"sha256": "eca214cb7f403d4e47a41b7a4db3f424d947177e06ac472a2a2d5fe3e0eafd9e"
},
"downloads": -1,
"filename": "pix2vec-0.1.5.tar.gz",
"has_sig": false,
"md5_digest": "88d4222ce0022adc7a2c1e52209d4fe4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 3438972,
"upload_time": "2023-08-01T17:02:30",
"upload_time_iso_8601": "2023-08-01T17:02:30.414277Z",
"url": "https://files.pythonhosted.org/packages/ca/81/dd20844e0621767bd3a0cd451bfef4ff65c3452d3dcf21b92143fab8795a/pix2vec-0.1.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-01 17:02:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "afrigeri",
"github_project": "pix2vec",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "kalasiris",
"specs": []
},
{
"name": "sphinx_rtd_theme",
"specs": []
},
{
"name": "gdal",
"specs": []
}
],
"tox": true,
"lcname": "pix2vec"
}
JSON
