Metadata-Version: 2.3
Name: archetypal
Version: 2.18.4
Summary: Retrieve, construct, simulate, convert and analyse building archetypes
License: MIT
Author: Samuel Letellier-Duchesne
Author-email: samuelduchesne@me.com
Requires-Python: >=3.9,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: beautifulsoup4 (<=4.8)
Requires-Dist: click (>=8.1.7,<9.0.0)
Requires-Dist: contourpy (>=1.2.1,<2.0.0)
Requires-Dist: coolprop (>=6.6.0,<7.0.0)
Requires-Dist: cycler (>=0.12.1,<0.13.0)
Requires-Dist: decorator (>=5.1.1,<6.0.0)
Requires-Dist: deprecation (>=2.1.0,<3.0.0)
Requires-Dist: energy_pandas (>=0.4.1,<0.5.0)
Requires-Dist: eppy (>=0.5.63,<0.6.0)
Requires-Dist: esoreader (>=1.2.3,<2.0.0)
Requires-Dist: eval-type-backport (>=0.2.0,<0.3.0) ; python_version == "3.9"
Requires-Dist: fonttools (>=4.53.0,<5.0.0)
Requires-Dist: future (>=1.0.0,<2.0.0)
Requires-Dist: kiwisolver (>=1.4.5,<2.0.0)
Requires-Dist: lxml (>=5.2.2,<6.0.0)
Requires-Dist: matplotlib (>=3.4,<4.0)
Requires-Dist: munch (>=4.0.0,<5.0.0)
Requires-Dist: networkx (<3)
Requires-Dist: numpy (>=2.0.2,<3.0.0) ; python_full_version <= "3.9.0"
Requires-Dist: numpy (>=2.1.1,<3.0.0) ; python_version == "3.10"
Requires-Dist: outdated (>=0.2.2,<0.3.0)
Requires-Dist: packaging (>=24.1,<25.0)
Requires-Dist: pandas (>=2.0.3)
Requires-Dist: path (>=16.14.0,<17.0.0)
Requires-Dist: pillow (>=10.3.0,<11.0.0)
Requires-Dist: pyclipper (>=1.3.0.post5,<2.0.0)
Requires-Dist: pycountry (>=24.6.1,<25.0.0)
Requires-Dist: pydantic-settings (>=2.3.2,<3.0.0)
Requires-Dist: pydot3k (>=1.0.17,<2.0.0)
Requires-Dist: pyparsing (>=3.1.2,<4.0.0)
Requires-Dist: pypoly2tri (>=0.0.3,<0.0.4)
Requires-Dist: python-dateutil (>=2.9.0.post0,<3.0.0)
Requires-Dist: requests (>=2.32.3,<3.0.0)
Requires-Dist: scikit-learn (>=1.5.0,<2.0.0)
Requires-Dist: shapely (>=2.0.6,<3.0.0)
Requires-Dist: sigfig (>=1.3.3,<2.0.0)
Requires-Dist: six (>=1.16.0,<2.0.0)
Requires-Dist: soupsieve (>=2.5,<3.0)
Requires-Dist: tomli (>=2.0.1,<3.0.0)
Requires-Dist: tqdm (>=4.66.4,<5.0.0)
Requires-Dist: transforms3d (>=0.4.1,<0.5.0)
Requires-Dist: typing-extensions (>=4.12.2,<5.0.0)
Requires-Dist: validator-collection (>=1.5.0,<2.0.0)
Description-Content-Type: text/markdown

[![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

Recommended to use a conda environement running python 3.8. Pip install should work on all platforms (linux, macOS and Windows).
First,

```cmd
conda create -n venv python=3.8
```

`-n venv` is the name of your environement; it can be anything.
Then,

```cmd
pip install -U archetypal
```

## Local Development

1. Clone this repo locally

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

2. Install dependencies:

```console
cd archetypal
conda env create
```

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

3. Run Tests:

```console
python -m pytest tests/
```

4. Generate Documentation:

```console
make html
```

