eemeter v0.4.0

[philngo]

This is a release candidate for eemeter 0.4. It includes a large set of updates at every layer, including in basic data structures, import/export tooling, weather handling and caching, meter structure, and logging.

Weather:

• Updated weather caching to use SQLite database instead of writing files. This will help with concurrency and streamlines persistent caching.
• Updated weather station mappings to restrict to US and territories.
• Updated weather station mappings more carefully handle the difference between ISD and TMY3 stations.
• Updated filtering for bad weather stations.

Energy Traces:

• Generalization of ConsumptionData to EnergyTrace, which recognize that not all the energy data we process is actually "Consumption."
• Updated parser to handle and output multiple traces of potentially different types.
• Separated record Serializers from EnergyTrace objects
• Allowed 'placeholder' traces.

Meters:

• Replaced of Period with Intervention periods and ModelingPeriods. This adds future proofing for as we develop ways to handle different projects
• Moved away from YAML meter definitions for meters and toward a more object-oriented interface which will allow for better inheritance patterns.
• Structured meter around handling of arbitrary ModelingPeriodSets and EnergyTraceSets
• Separated Formatter Validator, and Model interfaces, allowing more precise and predictable definitions models.
• Added dispatching of different models, formatters, and validators based on input data.

CI tooling:

• Use tox
• run flake8
• compute coverage
• build docs
• test on python 2.7, 3.4, 3.5

Documentation:

• Restructured documentation around "Guides"
• Removed generator module

[coveralls]

Coverage increased (+88.3%) to 88.286% when pulling efdf8e299dd1b1ebc57efa00f5419a1fdec67ead on feature/experimental-v0.4-prototyping into 174c91842969444d1ea092b4548bae690f39e1e0 on develop.

[marcpare]

What if logging emitted to a named logger instead? e.g.

logger = logging.getLogger("eemeter") https://docs.python.org/3.1/library/logging.html

Then you can attach to that logger if you want the logs. Seems a little more flexible than emitting the blob of logs in the meter run results.

[philngo]

Yeah, you're right. The logging stuff as set up right now is over-engineered and over-restrictive. Let's go with the more standard method you describe, but maybe we should use logger = logging.getLogger(__name__).

[coveralls]

Coverage increased (+88.4%) to 88.446% when pulling 6365e23edf1ceac911e62d4497a59456321be258 on feature/experimental-v0.4-prototyping into 174c91842969444d1ea092b4548bae690f39e1e0 on develop.

[coveralls]

Coverage increased (+88.6%) to 88.579% when pulling 10ede7bef3c56f059ac7ac867ee063ec3838449d on feature/experimental-v0.4-prototyping into 174c91842969444d1ea092b4548bae690f39e1e0 on develop.

[coveralls]

Coverage increased (+88.8%) to 88.838% when pulling 2255782eb4726be373fce0e19f2b047881af629b on feature/experimental-v0.4-prototyping into 174c91842969444d1ea092b4548bae690f39e1e0 on develop.

[coveralls]

Coverage increased (+88.8%) to 88.838% when pulling bfdc21a00f3d607d8d91a15cff72994e038f6853 on feature/experimental-v0.4-prototyping into 174c91842969444d1ea092b4548bae690f39e1e0 on develop.

[coveralls]

Coverage increased (+88.8%) to 88.838% when pulling 84d926a1a369327f9e7c52f5aab7df3fd3f17fa4 on feature/experimental-v0.4-prototyping into 174c91842969444d1ea092b4548bae690f39e1e0 on develop.

[coveralls]

Coverage increased (+88.8%) to 88.838% when pulling e9de2638a67a293db8fb2240e7ea23a0336a9fd9 on feature/experimental-v0.4-prototyping into 174c91842969444d1ea092b4548bae690f39e1e0 on develop.

[coveralls]

Coverage increased (+88.4%) to 88.432% when pulling 7c4d30577503203d9803faa6cf6b3792ce0c937c on feature/experimental-v0.4-prototyping into 174c91842969444d1ea092b4548bae690f39e1e0 on develop.

[coveralls]

Coverage increased (+88.6%) to 88.57% when pulling db879415166794fb9e33b94fcd1ce0533f2d1b36 on feature/experimental-v0.4-prototyping into 174c91842969444d1ea092b4548bae690f39e1e0 on develop.