Metadata-Version: 1.1
Name: movespy
Version: 0.1.7
Summary: Easy Python tools for EPA MOVES project-level analysis
Home-page: http://ericstalbot.github.com/movespy
Author: Eric S. Talbot
Author-email: UNKNOWN
License: UNKNOWN
Description: =======
        movespy
        =======
        
        ``movespy`` simplifies interaction with 
        MOVES_ and traffic microsimulation for project-level analysis. 
        
        .. _MOVES: http://www.epa.gov/otaq/models/moves/index.htm
        
        
        Dependencies
        ------------
        
        ``movespy`` depends on:
        
          - `numpy <http://www.numpy.org/>`_
          - `MySQLdb <http://sourceforge.net/projects/mysql-python/>`_
        
        
        Installation
        ------------
        
        Download the installer_ and run it.
        
        .. _installer: https://pypi.python.org/pypi/movespy
        
        
        Also edit the ``movespy_settings.py`` file:
        
          - ``moves_dir``: a string that is the path to you MOVES installation directory
          - ``moves_db``: a string that is the name of your MOVES database (assumed to be local)
        
        
        
        Usage
        -----
        
        The following code 
        executes a complete MOVES run and calculates the total CO emissions::
        
            >>> links = {1: {'grade': -1.2,
            ...              'length': 0.25,
            ...              'road_type': 5,
            ...              'source_distr': {21: 1.0}, 
            ...              'speed': 34,
            ...              'volume': 400}}  
        
            >>> activity =  {'age_distr': {21: {5: 1.0}},
            ...              'county': 50027, 
            ...              'day_type': 5, 
            ...              'hour': 16,
            ...              'month': 6,
            ...              'year': 2015,
            ...              'links': links}     
        
            >>> options = {'detail': 'average'}
                
            >>> import movespy.moves
            >>> moves = movespy.moves.Moves(activity, options)
            >>> emissions_out = moves.run()
            running MOVES ...
            >>> total_CO = sum([row['quantity'] for row in emissions_out if row['pollutant'] == 2])
            >>> print total_CO
            102.772
                
        
                
        This code calculates VSP and operating mode for a vehicle trajectory
        dataset::
        
            >>> veh = [1,1,1,1,2,2,2,3,3,3,3,3]
            >>> speed = [3.,6.,1.,3.,8.,5.,6.,3.,9.,1.,3.,9.]
            >>> grade = [1.,2.,-3.,1.,2.,1.,3.,1.,-2.,3.,-4.,-2.]
            >>> mass, mass_factor, alpha, beta, gamma = 2., 1.5, 0.16, 0.0020, 0.00049    
        
            >>> import movespy.trajectory
        
            >>> vsp, opmode = movespy.trajectory.getVSPOpMode(veh, speed, grade, mass, 
            ... mass_factor, alpha, beta, gamma)
            >>> print vsp[:3]
            [ 0.1462389   5.79980985 -1.45965811]
            >>> print opmode[:3]
            [12 13  0]
        
             
                
                
        For detailed instructions and examples see the `user manual`_.
        
        .. _user manual: http://ericstalbot.github.com/movespy/
        
                 
        
        
            
        
Platform: UNKNOWN
Requires: numpy
Requires: MySQLdb
