Skip to main content

Package for Measurement and Verification

Project description

Mave
======
Mave is a tool for automated measurement and verification. At it's most simple,
the aim is to read energy consumption data from before and after a retrofit
(pre-retrofit and post-retrofit data) and to predict how much energy the
retrofit saved. Mave does this by training a model to the data and using
the best model to predict energy consumption during a different period.


Installation
------------
Assuming all of the dependencies are installed, install mave from source using:
```
python setup.py install
```

Alternatively, install mave from pypi using:
```
pip install mave --no-deps
```

If you run into trouble with the dependencies, see the
[Installation page of the wiki](https://github.com/CenterForTheBuiltEnvironment/mave/wiki/Installation)

Usage
------------
Try mave out on an example file using any of the examples methods below.
Each of these will build a model on the dataset contained in ex3.csv, the
difference between the three approaches is in how the post-retrofit period
is defined.
```
mave ex3.csv
```
This assumes the last 25% of the file represents the postretrofit period as the
default value of the 'test_size' argument is 0.25.
```
mave ex3.csv -ts 0.45
```
This uses the 'ts' or 'test_size' argument to explicitly specify the fraction
of the file to use. In this example the last 45% of the file represents the
postretrofit period.
```
mave ex3.csv -cp "1/11/2013 00:00"
```
This example uses the 'cp' or 'changepoint' argument to explicitly define the
date at which the post retrofit period begins. This overrides the 'test-size'
value. In this case all data on or after Jan 11, 2013 at 00:00 represents the
post-retrofit period.

Mave has many configurable options (e.g. -v for verbose output) which can be
passed as command line arguments or using a separate configuration file.
The configuration file also allows many other advanced modeling options, such
as specifying multiple different periods in the file to use as pre-retrofit or
post-retrofit, or periods to ignore entirely. Review the wiki documentation for
more details.

To cite this tool:
Paul Raftery & Tyler Hoyt, 2015, Mave: software automated Measurement and Verification.
Center for the Built Environment, University of California Berkeley, https://github.com/CenterForTheBuiltEnvironment/mave

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
mave-0.0.42-py2-none-any.whl (5.3 MB) Copy SHA256 hash SHA256 Wheel 2.7

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page