Metadata-Version: 2.1
Name: waveglider-connect
Version: 0.5.1
Summary: Connector for getting data from Liquid Robotics Wave Glider AUV
Home-page: UNKNOWN
Author: Claas Faber, GEOMAR data management
License: NOT FOR PUBLIC USE
Requires-Dist: pandas
Requires-Dist: requests

do not distribute w/o prior consent of author(s)

Description: # waveglide_connect
        Data from GEOMAR and MARUM Wavegliders is accessed throug the
        Liquid Robitics web service. This connector accesses and converts WaveGlider
        Data.
        
        # Connected devices
        As of 2019-07-12, positions of 
        WaveGliders *GEOMAR 2 (CVOO)*, *GEOMAR 4 (MOSES)* und *MARUM* are evaluated.
        
        **Device data contact**: 
        Patrick Leibold <pleibold@geomar.de>
        
        # Installation
        ## Release version
        ```bash
        pip install --index-url https://pypi.fury.io/cfgmr/ waveglider-connect
        ```
        ## From source
        ```bash
        git clone git@git.geomar.de:moses/moses_tools/waveglider_connect.git
        cd waveglider_connect
        pip install -e .
        ```
        
        # Configuration
        Needs key files for authentification with Liquid Robotics SOAP interface.
        Seperate key files for GEOMAR and MARUM gliders needed.
        Set by exporting as environment variable:
        ```bash
        export WGC_AUTH_FILE_GMR=/srv/bin/ingest_store/VERY_SECRET.xml
        export WGC_AUTH_FILE_MARUM=/srv/bin/ingest_store/ALSO_SECRET.xml
        ```
        
        # Usage
        ```python
        (venv) [datamanagement@dm-ingest-www bin]$ export WGC_AUTH_FILE_GMR=/srv/bin/ingest_store/VERY_SECRET.xml
        (venv) [datamanagement@dm-ingest-www bin]$ export WGC_AUTH_FILE_MARUM=/srv/bin/ingest_store/ALSO_SECRET.xml
        (venv) [datamanagement@dm-ingest-www bin]$ ipython
        impoPython 3.6.8 (default, Apr 25 2019, 21:02:35)
        Type 'copyright', 'credits' or 'license' for more information
        IPython 7.5.0 -- An enhanced Interactive Python. Type '?' for help.
        
        In [1]: import wgc
        
        In [2]: wgc.get_waveglider_data()
        2019-07-12 17:38:25,532 - wgc - INFO - Got data for gliders []
        2019-07-12 17:38:27,514 - wgc - INFO - Got data for gliders ['1622:WG_M']
        Out[2]:
            platform_shortname       obs_timestamp       lat       lon  speed_over_ground heading
        10                WG_M 2019-06-25 18:31:00  27.99237 -15.36882           1.781857      24
        11                WG_M 2019-06-25 18:29:00  27.99204 -15.36898           1.960043     213
        [...]
        ```
        
        
        
        
        
        
Platform: UNKNOWN
Requires-Python: >= 3.6