Metadata-Version: 1.2
Name: pix2vec
Version: 0.1.1
Summary: Vector Representation of Hyperspectral Data
Home-page: https://github.com/afrigeri/pix2vec
Author: Alessandro Frigeri
Author-email: alessandro.frigeri@inaf.it
License: GNU General Public License v3
Description: ===============
        pix2vec
        ===============
        *Geospatial Vector Representation of Remote Sensing Hyperspectral Data*
        
        ---------------------------------
        
        
        .. image:: https://img.shields.io/pypi/v/pix2vec.svg
                :target: https://pypi.python.org/pypi/pix2vec
        
        .. image:: https://img.shields.io/travis/afrigeri/pix2vec.svg
                :target: https://travis-ci.com/afrigeri/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 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 ISIS installation
        
        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.
        
        
        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 152,162 -l5864,5874 -o M3G20090103T084105_V03_L1B_center.gpkg 
        
        the vector file can then be loaded in your favorite GIS, and we can plot the `PixelValue` field:
        
        .. image:: docs/images/m3cube-c.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
        
        
        Credits
        -------
        
        This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.
        
        .. _Cookiecutter: https://github.com/audreyr/cookiecutter
        .. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage
        
        
        =======
        History
        =======
        
        0.1.0 (2023-06-21)
        ------------------
        
        * First release on PyPI.
        
Keywords: pix2vec
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
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
