Metadata-Version: 1.1
Name: CoCoRaHS-Download-Tool
Version: 0.0.3
Summary: Tool to download CoCoRaHS data.
Home-page: https://bitbucket.org/nmclimate/cocorahs-download-tool
Author: Stanley Engle
Author-email: sengle@nmsu.edu
License: BSD License
Description: ======================
        CoCoRaHS-Download-Tool
        ======================
        
        Tool to download CoCoRaHS data.
        
        
        Requirements
        ============
        
        - Python >= 2.6
        
        
        Installation
        ============
        
        To get started using **CoCoRaHS-Download-Tool** simply install it with **pip**::
        
            $ pip install CoCoRaHS-Download-Tool
        
        Or, use *pip* locally with the .tar.gz distribution file::
        
            $ pip install CoCoRaHS-Download-Tool-0.0.2.tar.gz
        
        
        Usage
        =====
        
        The **CoCoRaHS-Download-Tool** tool has two modes of operation, listing of 
        CoCoRaHS station metadata, and listing of CoCoRaHS station data.
        
        Stations Metadata
        -----------------
        
        To list CoCoRaHS stations metadata for the default state (NM) the following 
        command is issued::
        
            $ python -m cocorahs_dlt stations
        
        To save the output of this operation, run::
        
            $ python -m cocorahs_dlt stations > stations.csv
        
        To download and save CoCoRaHS stations metadata for a different state 
        (specified by the two-character state code), the following command is 
        issued::
        
            $ python -m cocorahs_dlt --state CO stations > stations.csv
        
        
        Stations Data
        -------------
        
        To list CoCoRaHS stations data for the default state (NM), the default
        date range (last three days), and the default output (CSV) the following 
        command is issued::
        
            $ python -m cocorahs_dlt data
        
        To save the output of this operation, run::
        
            $ python -m cocorahs_dlt data > data.csv
        
        To download and save CoCoRaHS stations data for a different state 
        (specified by the two-character state code), the following command is 
        issued::
        
            $ python -m cocorahs_dlt --state CO data > data.csv
        
        To download and save CoCoRaHS stations data for a different state 
        (specified by the two-character state code) and in a different output format, 
        the following command is issued::
        
            $ python -m cocorahs_dlt --state CO data --format XML > data.xml
        
        To download and save CoCoRaHS stations data for a different state 
        (specified by the two-character state code) in a different output format, and 
        with volunteer comments, the following command is issued::
        
            $ python -m cocorahs_dlt --state CO data --format XML --comments > data.xml
        
        To download and save CoCoRaHS stations data for a different state 
        (specified by the two-character state code) in a different output format, 
        with volunteer comments, and for a different date range, the following command 
        is issued::
        
            $ python -m cocorahs_dlt --state CO data --format XML --comments --start_date 2014-09-13 --end_date 2014-09-21 > data.xml
        
        To only list the data from the previous command, the *> data.xml* text is dropped::
        
            $ python -m cocorahs_dlt --state CO data --format XML --comments --start_date 2014-09-13 --end_date 2014-09-21
        
        
        
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
