{ "info": { "author": "Alex Guinman", "author_email": "alex@guinman.id.au", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 3" ], "description": "# nem-reader\n\n[![PyPI version](https://badge.fury.io/py/nemreader.svg)](https://badge.fury.io/py/nemreader) [![Build Status](https://travis-ci.org/aguinane/nem-reader.svg?branch=master)](https://travis-ci.org/aguinane/nem-reader) [![Coverage Status](https://coveralls.io/repos/github/aguinane/nem-reader/badge.svg)](https://coveralls.io/github/aguinane/nem-reader)\n\nThe Australian Energy Market Operator (AEMO) defines a [Meter Data File Format (MDFF)](https://www.aemo.com.au/Stakeholder-Consultation/Consultations/Meter-Data-File-Format-Specification-NEM12-and-NEM13) for reading energy billing data.\nThis library sets out to parse these NEM12 (interval metering data) and NEM13 (accumulated metering data) data files into a useful python object, for use in other projects.\n\n## Usage\n\nFirst, read in the NEM file:\n```python\nfrom nemreader import read_nem_file\nm = read_nem_file('examples/unzipped/Example_NEM12_actual_interval.csv')\n```\n\nYou can see what data for the NMI and suffix (channel) is available:\n```python\n> print(m.header)\nHeaderRecord(version_header='NEM12', creation_date=datetime.datetime(2004, 4, 20, 13, 0), from_participant='MDA1', to_participant='Ret1')\n\n> print(m.transactions)\n{'VABD000163': {'E1': [], 'Q1': []}}\n```\n\nStandard suffix/channels are defined in the [National Metering Identifier Procedure](https://www.aemo.com.au/-/media/Files/Electricity/NEM/Retail_and_Metering/Metering-Procedures/2018/MSATS-National-Metering-Identifier-Procedure.pdf).\n`E1` is the general consumption channel (`11` for NEM13).\n\nMost importantly, you will want to get the energy data itself:\n\n```python\n> for nmi in m.readings:\n> for channel in m.readings[nmi]:\n> for reading in m.readings[nmi][suffix][-1:]:\n> print(reading)\nReading(t_start=datetime.datetime(2004, 4, 17, 23, 30), t_end=datetime.datetime(2004, 4, 18, 0, 0), read_value=14.733, uom='kWh', quality_method='S14', event='', read_start=None, read_end=None)\n```\n\n## Command Line Usage\n\nYou can also output the NEM file in a more human readable format:\n\n```shell\nnemreader output example.zip\n```\n\nWhich outputs transposed values to a csv file for all channels:\n\n```\nperiod_start,period_end,E1,Q1,quality_method\n2004-02-01 00:00:00,2004-02-01 00:30:00,1.111,2.222,A\n2004-02-01 00:30:00,2004-02-01 01:00:00,1.111,2.222,A\n...\n```\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/aguinane/nem-reader", "keywords": "energy,NEM12,NEM13", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "nemreader", "package_url": "https://pypi.org/project/nemreader/", "platform": "", "project_url": "https://pypi.org/project/nemreader/", "project_urls": { "Homepage": "https://github.com/aguinane/nem-reader" }, "release_url": "https://pypi.org/project/nemreader/0.4/", "requires_dist": [ "click" ], "requires_python": ">=3.6", "summary": "Parse NEM12 (interval metering data) and NEM13 (accumulated metering data) data files", "version": "0.4" }, "last_serial": 5922201, "releases": { "0.1.2": [ { "comment_text": "", "digests": { "md5": "35c1e988bca019e3fb5f750686841a94", "sha256": "606dde9099d85ec6cfe60b83efa77e3962303a0e9b6cd02038c89ae03ba4a7f7" }, "downloads": -1, "filename": "nemreader-0.1.2.tar.gz", "has_sig": false, "md5_digest": "35c1e988bca019e3fb5f750686841a94", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3139, "upload_time": "2017-02-24T11:08:08", "url": "https://files.pythonhosted.org/packages/c4/ad/ffdf4de1aa925915883db8c967856a0b0854f8e2fba4fb5fb4ff087090e3/nemreader-0.1.2.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "bc5af376ceb5401853c9972d4a46f6df", "sha256": "5926315fff504316a1baee93fe5a84cf9e0d501aa8465da69548b35341c179f4" }, "downloads": -1, "filename": "nemreader-0.2.0.tar.gz", "has_sig": false, "md5_digest": "bc5af376ceb5401853c9972d4a46f6df", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3182, "upload_time": "2017-02-24T12:07:31", "url": "https://files.pythonhosted.org/packages/e3/ed/63f3b248a9b252c8ddc20f514d2e59204ba88c4c6d8edcb479fec9dfa23a/nemreader-0.2.0.tar.gz" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "bbdc3ffbc16990546d352c2f94444ec4", "sha256": "2bfc61065fcf06eba663548a340fac40ddeb447b27b2508dfff26ba5f8001860" }, "downloads": -1, "filename": "nemreader-0.2.1-py3-none-any.whl", "has_sig": false, "md5_digest": "bbdc3ffbc16990546d352c2f94444ec4", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 7720, "upload_time": "2017-12-17T08:02:20", "url": "https://files.pythonhosted.org/packages/3a/8b/80579513c718f076526ccb35fdd2b26d1d5da1ed0e5c04253f116b072a4c/nemreader-0.2.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "374fbc397a09558be98039af6f960d6d", "sha256": "703f0bc65f997923b54fad8c000ea4f49a75e85b8b57d70357d9876ed86796e1" }, "downloads": -1, "filename": "nemreader-0.2.1.tar.gz", "has_sig": false, "md5_digest": "374fbc397a09558be98039af6f960d6d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4654, "upload_time": "2017-12-17T08:02:22", "url": "https://files.pythonhosted.org/packages/28/fd/9a7cabaf633057120df3dd9a03f46a3ead05632dabf9c1d305042415d266/nemreader-0.2.1.tar.gz" } ], "0.2.2": [ { "comment_text": "", "digests": { "md5": "07c0689e2b32063d6a3392bd547f683a", "sha256": "889a77f1b450d30a38e59e8804d309177a90791c231b2cf4697e8f78c09c356f" }, "downloads": -1, "filename": "nemreader-0.2.2-py3-none-any.whl", "has_sig": false, "md5_digest": "07c0689e2b32063d6a3392bd547f683a", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 8075, "upload_time": "2018-03-30T08:21:38", "url": "https://files.pythonhosted.org/packages/05/1c/8fdbc4b3cc4a5c3dffaf365317cbb4d21724ba737edab085970c0c2f5955/nemreader-0.2.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "28950cf18b96d75e026eb7f01627a1d8", "sha256": "13f83f6d5709830f34199d466a4c18ba5bcb18548aab457f5cfc6400a71f9c5d" }, "downloads": -1, "filename": "nemreader-0.2.2.tar.gz", "has_sig": false, "md5_digest": "28950cf18b96d75e026eb7f01627a1d8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5048, "upload_time": "2018-03-30T08:21:40", "url": "https://files.pythonhosted.org/packages/06/80/3adbdca9eb17698ddc7096a86f049dba4426633051c157dd9b2476252b35/nemreader-0.2.2.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "b88300646da8d4bced55cf540f315b21", "sha256": "cb64fdcb586dd4fa3f98a3e26815772242563b3c3b03c75a9ee30832e6141618" }, "downloads": -1, "filename": "nemreader-0.3.0-py3-none-any.whl", "has_sig": false, "md5_digest": "b88300646da8d4bced55cf540f315b21", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 7027, "upload_time": "2018-12-09T23:50:26", "url": "https://files.pythonhosted.org/packages/1b/1b/adb066ec064421f4d54f7461db062e026185db5c1f57c20089cd55422259/nemreader-0.3.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "99474f7a45293bd2674e2344b532f62e", "sha256": "c7275292e4081d13a3651b9f2114331fed2a8eef2a0e31d930a0875154992cff" }, "downloads": -1, "filename": "nemreader-0.3.0.tar.gz", "has_sig": false, "md5_digest": "99474f7a45293bd2674e2344b532f62e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6337, "upload_time": "2018-12-09T23:50:28", "url": "https://files.pythonhosted.org/packages/af/2e/9f8225c5a502a61122a491c153ac411ab9dd3b26cfad8423dda8b8ee9156/nemreader-0.3.0.tar.gz" } ], "0.3.1": [ { "comment_text": "", "digests": { "md5": "9b95989d167bf71b94f3bc71ee7dc768", "sha256": "c9253260608900fb302a633aeb9f775f06a504bec3058eeeff13f4d796a64a10" }, "downloads": -1, "filename": "nemreader-0.3.1-py3-none-any.whl", "has_sig": false, "md5_digest": "9b95989d167bf71b94f3bc71ee7dc768", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.4", "size": 8280, "upload_time": "2019-08-09T23:58:06", "url": "https://files.pythonhosted.org/packages/17/03/025e90557ce225a8ee188a7b881974894dee486fa770837269b9b80e2693/nemreader-0.3.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "d2d1ab82349893dc4b13dc38e9e24af5", "sha256": "8d813a8b89388baaebabed785808477e94f8314748da43544350339d6cf9edec" }, "downloads": -1, "filename": "nemreader-0.3.1.tar.gz", "has_sig": false, "md5_digest": "d2d1ab82349893dc4b13dc38e9e24af5", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.4", "size": 7205, "upload_time": "2019-08-09T23:58:08", "url": "https://files.pythonhosted.org/packages/14/68/a267bb45a31f9c0cca4f676720c41e53c746224059c6a044c72babbcb608/nemreader-0.3.1.tar.gz" } ], "0.4": [ { "comment_text": "", "digests": { "md5": "70251fac273524e77691af347f08ee32", "sha256": "28e4be7dbe420c7c786c5db6872ceb1d8cc843104d7e7c12aa366624d616c718" }, "downloads": -1, "filename": "nemreader-0.4-py3.7.egg", "has_sig": false, "md5_digest": "70251fac273524e77691af347f08ee32", "packagetype": "bdist_egg", "python_version": "3.7", "requires_python": ">=3.6", "size": 19512, "upload_time": "2019-10-03T07:51:04", "url": "https://files.pythonhosted.org/packages/d6/28/800c0f3e63bca5dd0a52157977a0f9d1f2b4cc15ba542a1e356e653ff9f9/nemreader-0.4-py3.7.egg" }, { "comment_text": "", "digests": { "md5": "447cdf6c89d0928bd09710d8b3f775ea", "sha256": "e62601ca816e29e6dd07977558bc26adfeed021d6fb908b5aa97183479537bf9" }, "downloads": -1, "filename": "nemreader-0.4-py3-none-any.whl", "has_sig": false, "md5_digest": "447cdf6c89d0928bd09710d8b3f775ea", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6", "size": 10219, "upload_time": "2019-10-03T07:51:01", "url": "https://files.pythonhosted.org/packages/37/19/110b363fa8275ac057a31dc6dc0f00f5ee303c8e8e66afc64930337854d5/nemreader-0.4-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "313ad20d89afe7912dff8ee886c911cd", "sha256": "c84e8bc5b6fb2d3a6c1bc2acefd16d1dbe193a145a77d842960497fcb9fdeff4" }, "downloads": -1, "filename": "nemreader-0.4.tar.gz", "has_sig": false, "md5_digest": "313ad20d89afe7912dff8ee886c911cd", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 8848, "upload_time": "2019-10-03T07:51:06", "url": "https://files.pythonhosted.org/packages/7a/93/b7dc5ea4c1b6c4dfb14b3964b0f8fe11d87a1ea17ae268995fa84885e6a1/nemreader-0.4.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "70251fac273524e77691af347f08ee32", "sha256": "28e4be7dbe420c7c786c5db6872ceb1d8cc843104d7e7c12aa366624d616c718" }, "downloads": -1, "filename": "nemreader-0.4-py3.7.egg", "has_sig": false, "md5_digest": "70251fac273524e77691af347f08ee32", "packagetype": "bdist_egg", "python_version": "3.7", "requires_python": ">=3.6", "size": 19512, "upload_time": "2019-10-03T07:51:04", "url": "https://files.pythonhosted.org/packages/d6/28/800c0f3e63bca5dd0a52157977a0f9d1f2b4cc15ba542a1e356e653ff9f9/nemreader-0.4-py3.7.egg" }, { "comment_text": "", "digests": { "md5": "447cdf6c89d0928bd09710d8b3f775ea", "sha256": "e62601ca816e29e6dd07977558bc26adfeed021d6fb908b5aa97183479537bf9" }, "downloads": -1, "filename": "nemreader-0.4-py3-none-any.whl", "has_sig": false, "md5_digest": "447cdf6c89d0928bd09710d8b3f775ea", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6", "size": 10219, "upload_time": "2019-10-03T07:51:01", "url": "https://files.pythonhosted.org/packages/37/19/110b363fa8275ac057a31dc6dc0f00f5ee303c8e8e66afc64930337854d5/nemreader-0.4-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "313ad20d89afe7912dff8ee886c911cd", "sha256": "c84e8bc5b6fb2d3a6c1bc2acefd16d1dbe193a145a77d842960497fcb9fdeff4" }, "downloads": -1, "filename": "nemreader-0.4.tar.gz", "has_sig": false, "md5_digest": "313ad20d89afe7912dff8ee886c911cd", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 8848, "upload_time": "2019-10-03T07:51:06", "url": "https://files.pythonhosted.org/packages/7a/93/b7dc5ea4c1b6c4dfb14b3964b0f8fe11d87a1ea17ae268995fa84885e6a1/nemreader-0.4.tar.gz" } ] }