Skip to main content

Retrieve, construct, simulate, convert and analyse building archetypes

Project description

[![Build Status](https://github.com/samuelduchesne/archetypal/actions/workflows/python-package.yml/badge.svg?branch=main)](https://github.com/samuelduchesne/archetypal/actions/workflows/python-package.yml) [![Coverage Status](https://coveralls.io/repos/github/samuelduchesne/archetypal/badge.svg)](https://coveralls.io/github/samuelduchesne/archetypal) [![Documentation Status](https://readthedocs.org/projects/archetypal/badge/?version=latest)](https://archetypal.readthedocs.io/en/latest/?badge=latest) [![DOI](https://joss.theoj.org/papers/10.21105/joss.01833/status.svg)](https://doi.org/10.21105/joss.01833) [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

# Archetypal

python for building simulation archetypes

Retrieve, construct, simulate, convert and analyze building simulation templates

## Overview

Archetypal is a Python package that helps handle building archetypes.

## Changes since v2.0.0

The conversion of [EnergyPlus](https://energyplus.net) IDF models to Trnsys [TrnBuild](http://www.trnsys.com/features/suite-of-tools.php.html) Models (compatible with the multizone building model) is now part of a distinct package known as the [trnslator](https://github.com/louisleroy5/trnslator).

## Features

Here is a short overview of features that are part of archetypal:

  1. Building Complexity Reduction: A utility to transform a multizone EnergyPlus model to a two-zone normalized model. Such models are called building archetypes and are the foundation of the [UMI Energy Module](https://umidocs.readthedocs.io/en/latest/docs/model-setup-template.html). This tool will allow any EnergyPlus model to be imported into [UMI](http://web.mit.edu/sustainabledesignlab/projects/umi/index.html) and drastically speedup the UBEM process.

## Installation

pip install -U archetypal

To check if the command line interface is installed correctly use honeybee-energy –help.

## Local Development

  1. Clone this repo locally

`console git clone https://github.com/samuelduchesne/archetypal.git `

  1. Install dependencies:

`console cd archetypal conda env create `

This will create a new environment named archetypal. Don’t forget to activate the environment.

  1. Run Tests:

`console python -m pytest tests/ `

  1. Generate Documentation:

`console make html `

Project details


Download files

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

Files for archetypal, version 2.7.0
Filename, size File type Python version Upload date Hashes
Filename, size archetypal-2.7.0.tar.gz (12.1 MB) File type Source Python version None Upload date Hashes View
Filename, size archetypal-2.7.0-py3-none-any.whl (228.6 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page