{"id":50377615,"url":"https://github.com/winterweken/murb","last_synced_at":"2026-05-30T10:30:54.463Z","repository":{"id":357769082,"uuid":"1101671028","full_name":"winterweken/murb","owner":"winterweken","description":null,"archived":false,"fork":false,"pushed_at":"2026-05-24T00:20:15.000Z","size":259,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-24T02:19:30.204Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/winterweken.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-22T03:00:34.000Z","updated_at":"2026-05-24T00:07:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/winterweken/murb","commit_stats":null,"previous_names":["winterweken/murb"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/winterweken/murb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/winterweken%2Fmurb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/winterweken%2Fmurb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/winterweken%2Fmurb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/winterweken%2Fmurb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/winterweken","download_url":"https://codeload.github.com/winterweken/murb/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/winterweken%2Fmurb/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33689564,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-30T10:30:53.927Z","updated_at":"2026-05-30T10:30:54.454Z","avatar_url":"https://github.com/winterweken.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# murb_energy_tool\n\nA lightweight energy model based on PHPP and RETScreen. Uses hourly TMY (EPW) files, but data is aggregated into a monthly timestep. Mainly being used during early stage design to understand the minimum thermal envelope performance required given TEDI, TEUI and GHGI targets.\n\nThis project includes both a **Python library** for programmatic use and an interactive **Streamlit Web Application** for energy modelling.\n\n## Web Application\n\nThe interactive web application allows you to easily configure building geometry, windows, envelope, HVAC, and advanced settings to run simulations and generate downloadable reports.\n\n### Running the Web App locally\n\n1. Ensure you have installed the requirements (see [Installation](#installation) below).\n2. Activate your Python environment.\n3. From the root directory of the project, run:\n   ```bash\n   streamlit run webapp/app.py\n   ```\n4. The web interface will open in your default browser. Upload an EPW weather file, fill in the parameters, and click \"Run simulation\".\n\nAvailable Here: https://9s4appx5hvvwlnevx3mtxkj.streamlit.app\n\n## Installation\n\n### Anaconda (Recommended)\n\n#### Building the environment\n1. Open Anaconda Powershell Prompt and [create a fresh environment](https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html#creating-an-environment-with-commands) with Python version 3.10\n2. Activate the fresh environment and install pip (if Anaconda didn't do this automatically)\n3. Download or clone this repository and `cd` to the root folder of the repository\n4. Install the required packages with:\n   ```bash\n   python -m pip install -r requirements.txt\n   ```\n\u003e Note: The environment you just created has the packages necessary to run `murb_energy_tool` and the web app. You may want to install some additional ones, such as Jupyter Notebook, if you intend to run the example scripts.\n\n#### Installing the python module\nIf you wish to use the `murb_energy_tool` module globally in your environment:\n5. Find the location of the environment you just created. Possibly something like `C:\\Users\\Your Name\\AppData\\Local\\Continuum\\anaconda3\\envs\\[new env]` *(Hint: With the env activated in Anaconda Prompt run `conda info` and look for \"active env location\")*\n6. From the downloaded repository, copy the entire folder \"murb_energy_tool\" into the environment.\n\n#### Test the installation\n7. Open a Python terminal and try importing the package: \n   ```python\n   from murb_energy_tool import test\n   ```\n   If you see \"All tests passed\", the package has been installed correctly.\n\u003e Note: You will need to activate the environment you created each time you want to use the `murb_energy_tool` or run the web app.\n\n## Programmatic Usage\n\nFor Python scripting and API usage, see the [Jupyter Notebook examples](examples).\n\n## To-do\n- [x] Below-grade heat transfer\n- [ ] More precise COPs for heating and cooling plants\n- [x] Factor for non-normal irradiance on windows\n- [ ] Pumps and elevator loads\n- [ ] Report financial metrics\n- [ ] Documentation\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwinterweken%2Fmurb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwinterweken%2Fmurb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwinterweken%2Fmurb/lists"}