# Quick start

AT6012, the Grasshopper and Ladybug submodule. About ten minutes, and no Rhino
licence needed for any of it.

## 1. Check Python

```bash
python --version
```

Python 3.8 or newer. If it is missing, get it from python.org.

## 2. Set up

From inside this folder:

```bash
python -m venv venv

# Windows
venv\Scripts\activate
# macOS or Linux
source venv/bin/activate

pip install -r requirements.txt
```

That installs `ladybug-core` and `ladybug-comfort`, which are the same libraries
the Grasshopper components call.

## 3. Run the first analysis

Cork is already in `weather/`, so there is nothing to download.

```bash
python utci_from_epw.py weather/IRL_ST_Cork.AP.039550_TMYx.2011-2025.epw
```

You should see a UTCI annual mean of **2.82 C** and **30 hours** at no thermal
stress. If you get those two numbers, everything is installed correctly.

## 4. Run the comparison

```bash
python compare_locations.py weather/*.epw
```

Cork beside Rome. Read the last two lines of the output before anything else:
Cork's UTCI sits 7.65 C below its air temperature, Rome's only 1.73 C. That gap
is the module's question.

## 5. Add a third place

```bash
python fetch_weather.py --list
python fetch_weather.py --url <a zip url from climate.onebuilding.org> --into weather/
```

Pick somewhere you have a reason to compare against: where your project is,
where you are from, or a city with a climate you are arguing your project should
borrow from. Then run the comparison across all three.

## 6. Then open Grasshopper

`GRASSHOPPER.md` has the four definitions component by component. Build
definition 3, the UTCI one, and check it against the 2.82 C you already have. If
the canvas gives you something near 10 C you have left the wind input
unconnected, which is the first thing to check and the most common thing to get
wrong.

## What to write down as you go

The dossier wants the settings as well as the result. For any figure you report:

- which weather file, by full filename including the year span
- whether wind was included, and at what height
- whether mean radiant temperature was included, and what it assumed about
  shading
- that the file is a TMYx, so the figure describes the recent past

A UTCI number without those four is not checkable by anybody, including you in
six weeks.