Metadata-Version: 1.0
Name: gpxtools
Version: 0.2.1
Summary: Command line tools useful to manipulate GPX files.
Home-page: http://lichota.pl/blog/topics/gpxtools
Author: Wojciech Lichota
Author-email: wojciech@lichota.pl
License: GPL
Description: ========
        gpxtools
        ========
        
        Overview
        ========
        
        Command line tools useful to manipulate GPX files.
        
        
        Tools
        =====
        
        gpx-elevation-fix
        -----------------
        
        Fixes elevation (Z-axis) data in GPX file based on *Shuttle Radar Topography
        Mission* data. `SRTM`_ data are not available for whole globe. If SRTM data
        for position taken from GPX file do not exists, user will see download error
        of SRTM TIF file (for example srtm_38_00.TIF for Norway).
        
        More information about Shuttle Radar Topography Mission:
        
        * `SRTM`_ on CGIAR-CSI
        * `SRTM on Wikipedia`_
        * `SRTM world map`_
        
        gpx-cleanup
        -----------
        
        Removes from GPX file unnecessary data (e.g.: speed or course) stored by some GPS devices.
        
        
        gpx-compress
        ------------
        
        Removes unnecessary chars (e.g.: white spaces) to decrease GPX file size.
        
        
        Usage
        =====
        
        ::
        
        Usage: command-name [options]
        
        Options:
        -h, --help                show this help message and exit
        -i FILE, --intput=FILE    name of GPX input file, if not set stdin will be used
        -o FILE, --output=FILE    name of GPX output file, if not set stdout will be used
        
        Tools can be easily used in pipeline::
        
        cat input.gpx  | ./bin/gpx-fix-elevation | ./bin/gpx-cleanup | ./bin/gpx-compress > output.gpx
        
        
        Installation
        ============
        
        *gpxtools* requires `GDAL python bindings`_. This packege uses `GDAL library`_.
        You can build it form source or install from binary package.
        For more details see `GDAL library`_ homepage.
        
        For example in Ubuntu (feisty or higher) can be installed from package::
        
        sudo apt-get install python-gdal
        
        *gpxtools* requires also `lxml`_. To build it you can use `plone.recipe.lxml`_ buildout recipe.
        
        Installation with *easy_install*
        --------------------------------
        
        Run command::
        
        $ easy_install gpxtools
        
        
        Installation with *buildout*
        ----------------------------
        
        Save script in `buildout.cfg` file::
        
        [buildout]
        develop = .
        parts = gpxtools-script
        
        [gpxtools-script]
        recipe = zc.recipe.egg
        eggs = gpxtools
        
        Run commands::
        
        $ python bootstrap.py
        $ ./bin/buildout
        
        Commands will be created in *bin* subdirectory.
        
        
        References
        ==========
        
        * `gpxtools home page`_
        * `gpxtools at pypi`_
        * `GDAL python bindings`_
        * `GDAL library`_
        * `SRTM`_
        * `lxml`_
        * `plone.recipe.lxml`_
        * `SRTM on Wikipedia`_
        * `SRTM world map`_
        
        
        Authors & Contact
        =================
        
        * [sargo] - `Wojciech Lichota`_ <``wojciech[at]lichota.pl``>
        * [teo] - Matteo Gottardi <``matgott[at]tin.it``>
        
        .. _gpxtools home page: http://lichota.pl/blog/topics/gpxtools
        .. _gpxtools at pypi: http://pypi.python.org/pypi/gpxtools/
        .. _GDAL python bindings: http://pypi.python.org/pypi/GDAL
        .. _GDAL library: http://gdal.org/
        .. _SRTM: http://srtm.csi.cgiar.org/
        .. _lxml: http://pypi.python.org/pypi/lxml
        .. _plone.recipe.lxml: http://pypi.python.org/pypi/plone.recipe.lxml
        .. _SRTM on Wikipedia: http://en.wikipedia.org/wiki/Shuttle_Radar_Topography_Mission
        .. _SRTM world map: http://srtm.csi.cgiar.org/SRT_IMAGES/worldMap.jpg
        .. _Wojciech Lichota: http://lichota.pl/
        
        
        =========
        Changelog
        =========
        
        2010/02/15 0.2.1:
        =================
        
        - mkdir import fix [samuel.adam]
        
        
        2009/12/10 0.2.0:
        =================
        
        - Support for GPX 1.0 files [teo]
        - Add the <ele> tag if not present [teo]
        - Documentation update [sargo]
        
        
        2009/07/07 0.1.0:
        =================
        
        - Initial release [sargo]
        
Keywords: GPS GPX SRTM
Platform: UNKNOWN
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: Text Processing :: Markup :: XML
