https://github.com/mcneillj/sitka

A built environment analysis and modeling library for Python.
https://github.com/mcneillj/sitka

building-energy modeling-tool simulation

Last synced: 2 months ago
JSON representation

A built environment analysis and modeling library for Python.

• Host: GitHub
• URL: https://github.com/mcneillj/sitka
• Owner: mcneillj
• License: mit
• Created: 2018-11-09T21:15:20.000Z (about 6 years ago)
• Default Branch: main
• Last Pushed: 2022-04-30T16:47:53.000Z (almost 3 years ago)
• Last Synced: 2024-09-30T09:16:56.696Z (4 months ago)
• Topics: building-energy, modeling-tool, simulation
• Language: Python
• Homepage: http://www.sitka.io
• Size: 551 KB
• Stars: 10
• Watchers: 5
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# [Sitka](http://www.sitka.io/) · [![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/mcneillj/sitka/blob/master/LICENSE) [![codecov](https://codecov.io/gh/mcneillj/sitka/branch/master/graph/badge.svg)](https://codecov.io/gh/mcneillj/sitka) [![Build Status](https://travis-ci.org/mcneillj/sitka.svg?branch=master)](https://travis-ci.org/mcneillj/sitka)

Sitka is a built environment analysis and modeling library for Python.

This library is intended to make modeling and simulation for the built environment more hackable and easier to use for:

* Portable design tools

* Scalable web apps and services

* Quick design and analysis studies

* Interactive simulations and analyses

* Testing new models

The library is currently being written entirely in Python using [Pandas](https://pandas.pydata.org) as a core dependency in order to allow easier integration with data analysis in [Jupyter](https://jupyter.org).

A focus of this project is to create tools to make building models more hackable.  The library can be used to create a simple model just a few inputs or a larger whole building model can be created by connecting multiple objects.

## Installation

You can install Sitka on your local machine, virtualenv, or server.  It is completely written in Python, so it is easily portable to any machine with Python installed.  The `sitka` package is available on [pypi](https://pypi.org/project/sitka/).  The latest version can be installed using pip.

```sh

# using PyPI

pip install sitka

```

## Dependencies

- [NumPy](https://www.numpy.org): 1.19.2 or higher

- [Pandas](https://pandas.pydata.org): 1.1.2 or higher

## Features

* **Weather** - Import a weather file in EPW format and convert to series.

* **Solar:** Calculate solar angles for a site and determine solar radiation on surfaces.

* **Envelope and Constructions (FUTURE):** Wall and window construction models.

* **Thermal Zone (FUTURE):** Model thermal zones using the Heat Balance Method.

* **HVAC Systems (FUTURE):** Model air-side and water-side HVAC systems.

## Documentation

You can find the documentation [on the website](http://www.sitka.io).  

## Examples

Example files are provided in the [sitka-examples repo](https://www.github.com/mcneillj/sitka-examples).

## Contributing

Contributors are welcome.  You can start by submitting an [issue](https://www.github.com/mcneillj/sitka/issues).

### License

Sitka is [MIT licensed](./LICENSE).