Metadata-Version: 1.1
Name: davies
Version: 0.0.2
Summary: Package for manipulating cave survey data
Home-page: https://github.com/riggsd/davies
Author: David A. Riggs
Author-email: driggs@myotisoft.com
License: UNKNOWN
Description: Davies
        -------
        
        Davies is a Python package for manipulating cave survey data.
        
        It is currently in a very, very early phase of development, and should be considered a "proof of concept" implementation.
        
        
        Current support includes:
        
         - Parsing of `Compass <http://www.fountainware.com/compass/>`_ Project (.MAK) and Data (.DAT) source files, as well as
           Plot (.PLT) files.
        
         - That's it!
        
        
        Example usage::
        
          from davies import compass
        
          # Parse a .DAT file
          parser = compass.CompassDatParser('mycave.dat')
          surveys = parser.parse()
        
          print len(surveys)
          >> 17
        
          survey = surveys[0]
        
          print survey.name
          >> A
        
          print survey.date
          >> 2006-09-30
        
          print survey.shots[0]
          >> {'FROM': 'A1', 'TO': 'A2', 'LENGTH': 16.8, 'BEARING': 158.0, 'INC': -30.0, 'LEFT': 12.0, 'RIGHT': 15.0, 'UP': 15.0, 'DOWN': 20.0 }
        
          print survey.length
          >> 384.7
        
        
        Or a more useful example, which shows who has surveyed the most footage in your project::
        
            from davies import compass
        
            cavers = {}
        
            for datfile in sys.argv[1:]:
                for survey in compass.CompassDatParser(datfile).parse():
                    for member in survey.team:
                        cavers[member] = cavers.get(member, 0.0) + survey.length
        
            for name in sorted(cavers, key=cavers.get, reverse=True):
                print "%s:\t%0.1f" % (name, cavers[name])
        
        
        
        Installation
        ------------
        
        This software requires Python 2.7
        
        Releases are available for installation from the Python Package Index, see
        `installation instructions <https://wiki.python.org/moin/CheeseShopTutorial#Installing_Distributions>`_ or simply run
        the following command on Mac OS X or most Linux distributions.
        
        ``pip install davies``
        
        If you've downloaded a source distribution or checked out from the git repository, install locally with:
        
        ``python setup.py install``
        
        
        Name
        ----
        
        The name "Davies" is a tribute to `William E. Davies <http://www.aegweb.org/docs/about/william_davies_memorial.pdf>`_,
        who pioneered the systematic cave survey of West Virginia and authored *Caverns of West Virginia* in 1949. Bill Davies
        later did the statewide cave survey for the state of Maryland, served the roles of President and Vice-President of the
        National Speleological Society, and published the definitive US-wide karst map, *Engineering Aspects of Karst*. Davies
        still serves as an inspiration today to the cave mappers of West Virginia, of the United States, and the World over.
        
        
        License
        -------
        
        Davies is Open Source software licensed under the MIT License, and is copyright (C) Myotisoft LLC.
        
Keywords: cave,survey,gis
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2.7
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: Topic :: Scientific/Engineering :: GIS
