Metadata-Version: 2.1
Name: pix2vec
Version: 0.1.2
Summary: pix2vec produces a vector representation of planetary mapping spectrometers starting from hyperspectral an ISIS data cube
Home-page: https://github.com/afrigeri/pix2vec
Author: Alessandro Frigeri
Author-email: alessandro.frigeri@inaf.it
License: GNU General Public License v3
Keywords: pix2vec
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.6

===============
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:: /docs/images/m3-PixelValue.png
        :alt: M3-PixelValue
        :width: 600

each ground pixel element holds information that can be accessed:

.. image:: /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.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.


