[](https://mews.readthedocs.io/en/latest/?badge=latest)
The Multi-scenario Extreme Weather Simulator (MEWS) is a Python package designed to add
extreme weather events to existing weather data or projections. MEWS does not simulate
weather but rather adds variations in weather for the purpose of probabilistic analyses
of infrastructure or environmental systems.
Currently MEWS works for extreme temperature. Other enhancements to MEWS are envisioned that provide reasonably realistic selection
of hurricane futures and extreme precipitation.
Currently the infrastructure focus has been for Building Energy Simulation and MEWS can read/write
altered weather files for Energy Plus (https://energyplus.net/) and DOE-2 (https://www.doe2.com/)
weather files. Both of these provide a rich library of historic and Typical Meteorological weather
inputs around the world.
MEWS has been tested on Linux, Max-OS, and Windows using Python 3.8, 3.9, and 3.10.
Documentation will also follow in the near future.
License
------------
See the LICENSE.md file for license details. This package has third party packages that have their own licenses that are appended to the MEWS license.
Organization
------------
Directories
* mews - Python package
* dist - wheel and tar.gz binaries for installing mews 1.1
* docs - UNDER CONSTRUCTION - inital build available on ReadTheDocs (https://mews.readthedocs.io/en/latest/)
* information - contains general information about MEWS
* examples - current working example is run_mews_extreme_temperature_example_v_1_1.py. All others are deprecated or use older techniques
Installation
------------
* To install the latest released version:
```
pip install mews
```
For the current code:
```
cd < a directory you want to work with >
python -m venv <a virtual environment name>
<a virtual environment name>/Scripts/activate
git clone git@github.com:sandialabs/MEWS.git
cd MEWS
pip install -e .
```
If this does not work an alternative method is to:
```
cd < a directory you want to work with >
python -m venv <a virtual environment name>
<a virtual environment name>/Scripts/activate
git clone git@github.com:sandialabs/MEWS.git
cd MEWS
pip install -r requirements.txt
python setup.py develop
```
Then run the following to ensure the code passes unit testing
```
pip install pytest
pytest
```
All tests should pass. Sometimes failures occur if you have tex on your computer.
The API for MEWS is only documented in the code and has many inputs. The best example of how to use the latest version is available in examples/run_mews_extreme_temperature_example_v_1_1.py
the other examples are either depricated or are not being kept up to date presently.
Other Installation Requirements
-------------------------------
* MEWS requires Cython which needs a C compiler in place. For windows, this can be the visual studio free Microsoft Visual C++ 14.0 Build Tools
that are freely available at https://visualstudio.microsoft.com/visual-cpp-build-tools/. Download the build tools and install them. It is necessary
to assure the correct version of the build tools is installed. The stack exchange thread below shows how to verify the correct version is installed.
https://stackoverflow.com/questions/66838238/cython-setup-py-cant-find-installed-visual-c-build-tools
* MEWS downloads CMIP6 data when using the ClimateScenario class. This step can be messy though and requires many retries when downloading the data live from multiple servers. As a result, the entire dataset (~24Gb) has been uploaded to https://osf.io/ts9e8/files/osfstorage and is publicly available to manually download.
Download the CMIP6_Data_Files file and then make its local path equal to the "output_folder" parameter for the ClimateScenario class in
mews.weather.climate.ClimateScenario
Using MEWS
--------
A training video has been made available at: https://drive.google.com/file/d/1B-G5yGu0BFXCqj0BYfu_e8XFliAoeoRi/view?usp=drive_link
MEWS has many classes that have their API's documented in the code. These classes have specialized functions that most users will not want to work with.
The MEWS function for heat waves is:
```
from mews.run_mews import extreme_temperature
```
The example in MEWS/examples/run_mews_extreme_temperature_v_1_1.py shows how to use extreme_temperature. The repository now contains
pre-processed solution files for the following cities:
```
cities = ["Chicago",
"Baltimore",
"Minneapolis",
"Phoenix",
'Miami',
'Houston'
'Atlanta',
'LasVegas',
'LosAngeles',
'SanFrancisco',
'Albuquerque',
'Seattle',
'Denver',
'Helena',
'Duluth',
'Fairbanks',
'McAllen',
'Kodiak',
'Worcester']
```
The extreme_temperature input parameters can be used to only generate files from the solutions rather than running the lengthy optimization process again.
Inside "MEWS/examples/example_data" are folders for each city and inside these folders you can find the solution files in "results" and "mews_epw_results" folder for EnergyPlus epw files.
Contact
--------
* Daniel Villa, Sandia National Laboratories (SNL) dlvilla@sandia.gov
Citing MEWS
-----------
You can cite MEWS with one of the following:
* Villa, Daniel L., Tyler J. Schostek, Krissy Govertsen, and Madeline Macmillan. 2023. "A Stochastic Model of Future Extreme Temperature Events for Infrastructure Analysis." _Environmental Modeling & Software_ https://doi.org/10.1016/j.envsoft.2023.105663.
* Villa, Daniel L., Juan Carvallo, Carlo Bianchi, and Sang Hoon Lee. 2022. "Multi-scenario Extreme Weather Simulator Application to Heat Waves." _2022 Building Performance Analysis Conference and SimBuild co-organized by ASHRAE and IBPSA-USA_ https://doi.org/10.26868/25746308.2022.C006
Sandia Funding Statement
------------------------
Sandia National Laboratories is a multimission laboratory managed and operated by National Technology and Engineering Solutions of Sandia, LLC., a wholly owned subsidiary of Honeywell International, Inc., for the U.S. Department of Energy's National Nuclear Security Administration under contract DE-NA-0003525.
Raw data
{
"_id": null,
"home_page": "https://github.com/sandialabs/MEWS",
"name": "mews",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "dlvilla@sandia.gov",
"keywords": "Building Energy Modeling,Infrastructure,Extreme Weather,Markov,Resilience,Energy Plus,DOE2,DOE-2",
"author": "MEWS Developers",
"author_email": "dlvilla@sandia.gov",
"download_url": "https://files.pythonhosted.org/packages/54/a1/20ee145d52bf1435e86b92d5115a8be351df7cdc3d8b5c2fc894ef727d1b/mews-1.1.1.tar.gz",
"platform": null,
"description": "\r\n[](https://mews.readthedocs.io/en/latest/?badge=latest)\r\n\r\n\r\n\r\nThe Multi-scenario Extreme Weather Simulator (MEWS) is a Python package designed to add\r\nextreme weather events to existing weather data or projections. MEWS does not simulate\r\nweather but rather adds variations in weather for the purpose of probabilistic analyses \r\nof infrastructure or environmental systems. \r\n\r\nCurrently MEWS works for extreme temperature. Other enhancements to MEWS are envisioned that provide reasonably realistic selection\r\nof hurricane futures and extreme precipitation.\r\n\r\nCurrently the infrastructure focus has been for Building Energy Simulation and MEWS can read/write\r\naltered weather files for Energy Plus (https://energyplus.net/) and DOE-2 (https://www.doe2.com/)\r\nweather files. Both of these provide a rich library of historic and Typical Meteorological weather\r\ninputs around the world. \r\n\r\nMEWS has been tested on Linux, Max-OS, and Windows using Python 3.8, 3.9, and 3.10. \r\nDocumentation will also follow in the near future.\r\n\r\nLicense\r\n------------\r\n\r\nSee the LICENSE.md file for license details. This package has third party packages that have their own licenses that are appended to the MEWS license.\r\n\r\nOrganization\r\n------------\r\n\r\nDirectories\r\n * mews - Python package\r\n * dist - wheel and tar.gz binaries for installing mews 1.1\r\n * docs - UNDER CONSTRUCTION - inital build available on ReadTheDocs (https://mews.readthedocs.io/en/latest/)\r\n * information - contains general information about MEWS\r\n * examples - current working example is run_mews_extreme_temperature_example_v_1_1.py. All others are deprecated or use older techniques\r\n\r\nInstallation\r\n------------\r\n * To install the latest released version:\r\n \r\n ```\r\n pip install mews\r\n ```\r\n \r\n For the current code:\r\n \r\n ```\r\n cd < a directory you want to work with >\r\n python -m venv <a virtual environment name>\r\n <a virtual environment name>/Scripts/activate\r\n git clone git@github.com:sandialabs/MEWS.git\r\n cd MEWS\r\n pip install -e .\r\n ```\r\n If this does not work an alternative method is to:\r\n \r\n ```\r\n cd < a directory you want to work with >\r\n python -m venv <a virtual environment name>\r\n <a virtual environment name>/Scripts/activate\r\n git clone git@github.com:sandialabs/MEWS.git\r\n cd MEWS\r\n pip install -r requirements.txt\r\n python setup.py develop\r\n ```\r\n \r\n Then run the following to ensure the code passes unit testing\r\n \r\n ```\r\n pip install pytest\r\n pytest\r\n ```\r\n \r\n All tests should pass. Sometimes failures occur if you have tex on your computer.\r\n \r\n The API for MEWS is only documented in the code and has many inputs. The best example of how to use the latest version is available in examples/run_mews_extreme_temperature_example_v_1_1.py\r\n the other examples are either depricated or are not being kept up to date presently.\r\n\r\nOther Installation Requirements\r\n-------------------------------\r\n * MEWS requires Cython which needs a C compiler in place. For windows, this can be the visual studio free Microsoft Visual C++ 14.0 Build Tools \r\nthat are freely available at https://visualstudio.microsoft.com/visual-cpp-build-tools/. Download the build tools and install them. It is necessary\r\nto assure the correct version of the build tools is installed. The stack exchange thread below shows how to verify the correct version is installed.\r\n\r\nhttps://stackoverflow.com/questions/66838238/cython-setup-py-cant-find-installed-visual-c-build-tools\r\n\r\n * MEWS downloads CMIP6 data when using the ClimateScenario class. This step can be messy though and requires many retries when downloading the data live from multiple servers. As a result, the entire dataset (~24Gb) has been uploaded to https://osf.io/ts9e8/files/osfstorage and is publicly available to manually download.\r\n\r\nDownload the CMIP6_Data_Files file and then make its local path equal to the \"output_folder\" parameter for the ClimateScenario class in\r\n\r\nmews.weather.climate.ClimateScenario\r\n\r\nUsing MEWS\r\n--------\r\nA training video has been made available at: https://drive.google.com/file/d/1B-G5yGu0BFXCqj0BYfu_e8XFliAoeoRi/view?usp=drive_link\r\n\r\nMEWS has many classes that have their API's documented in the code. These classes have specialized functions that most users will not want to work with.\r\nThe MEWS function for heat waves is:\r\n\r\n```\r\nfrom mews.run_mews import extreme_temperature\r\n```\r\n\r\nThe example in MEWS/examples/run_mews_extreme_temperature_v_1_1.py shows how to use extreme_temperature. The repository now contains\r\npre-processed solution files for the following cities: \r\n\r\n```\r\ncities = [\"Chicago\",\r\n \"Baltimore\",\r\n \"Minneapolis\",\r\n \"Phoenix\",\r\n 'Miami',\r\n 'Houston'\r\n 'Atlanta', \r\n 'LasVegas',\r\n 'LosAngeles',\r\n 'SanFrancisco',\r\n 'Albuquerque',\r\n 'Seattle', \r\n 'Denver',\r\n 'Helena', \r\n 'Duluth',\r\n 'Fairbanks',\r\n 'McAllen',\r\n 'Kodiak',\r\n 'Worcester']\r\n ```\r\n \r\nThe extreme_temperature input parameters can be used to only generate files from the solutions rather than running the lengthy optimization process again.\r\n\r\nInside \"MEWS/examples/example_data\" are folders for each city and inside these folders you can find the solution files in \"results\" and \"mews_epw_results\" folder for EnergyPlus epw files. \r\n\r\nContact \r\n--------\r\n\r\n * Daniel Villa, Sandia National Laboratories (SNL) dlvilla@sandia.gov\r\n \r\nCiting MEWS\r\n-----------\r\nYou can cite MEWS with one of the following:\r\n\r\n* Villa, Daniel L., Tyler J. Schostek, Krissy Govertsen, and Madeline Macmillan. 2023. \"A Stochastic Model of Future Extreme Temperature Events for Infrastructure Analysis.\" _Environmental Modeling & Software_ https://doi.org/10.1016/j.envsoft.2023.105663.\r\n\r\n* Villa, Daniel L., Juan Carvallo, Carlo Bianchi, and Sang Hoon Lee. 2022. \"Multi-scenario Extreme Weather Simulator Application to Heat Waves.\" _2022 Building Performance Analysis Conference and SimBuild co-organized by ASHRAE and IBPSA-USA_ https://doi.org/10.26868/25746308.2022.C006\r\n\r\n\r\nSandia Funding Statement\r\n------------------------\r\nSandia National Laboratories is a multimission laboratory managed and operated by National Technology and Engineering Solutions of Sandia, LLC., a wholly owned subsidiary of Honeywell International, Inc., for the U.S. Department of Energy's National Nuclear Security Administration under contract DE-NA-0003525.\r\n\r\n\r\n\r\n",
"bugtrack_url": null,
"license": "Revised BSD",
"summary": "Multi-scenario Extreme Weather Simulator (MEWS)",
"version": "1.1.1",
"project_urls": {
"Download": "https://github.com/sandialabs/MEWS/archive/refs/tags/v0.1.0.tar.gz",
"Homepage": "https://github.com/sandialabs/MEWS"
},
"split_keywords": [
"building energy modeling",
"infrastructure",
"extreme weather",
"markov",
"resilience",
"energy plus",
"doe2",
"doe-2"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c44835e7e5a13b7fb1c48208561d972d45e0187e2a0edfab82bf8f936604c379",
"md5": "a497dc0d84ef7e11eb3abc259caebb23",
"sha256": "841c12f2548ea519e12a68e243643ee3992d3af0e54015c52a6131abba352252"
},
"downloads": -1,
"filename": "mews-1.1.1-cp39-cp39-win_amd64.whl",
"has_sig": false,
"md5_digest": "a497dc0d84ef7e11eb3abc259caebb23",
"packagetype": "bdist_wheel",
"python_version": "cp39",
"requires_python": null,
"size": 327100,
"upload_time": "2023-07-26T21:50:23",
"upload_time_iso_8601": "2023-07-26T21:50:23.084640Z",
"url": "https://files.pythonhosted.org/packages/c4/48/35e7e5a13b7fb1c48208561d972d45e0187e2a0edfab82bf8f936604c379/mews-1.1.1-cp39-cp39-win_amd64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "54a120ee145d52bf1435e86b92d5115a8be351df7cdc3d8b5c2fc894ef727d1b",
"md5": "c5c0ea636b65668e42ba39285ab1ce03",
"sha256": "7210b6ed23ccdaaaaca30aafc0226e6dbb735ca2604d08bd0504a8ab16b953f4"
},
"downloads": -1,
"filename": "mews-1.1.1.tar.gz",
"has_sig": false,
"md5_digest": "c5c0ea636b65668e42ba39285ab1ce03",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 197063,
"upload_time": "2023-07-26T21:53:11",
"upload_time_iso_8601": "2023-07-26T21:53:11.898304Z",
"url": "https://files.pythonhosted.org/packages/54/a1/20ee145d52bf1435e86b92d5115a8be351df7cdc3d8b5c2fc894ef727d1b/mews-1.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-07-26 21:53:11",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "sandialabs",
"github_project": "MEWS",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "mews"
}
JSON
