Saving, loading and exporting
GHE Analysis stores each project in a single file that captures the complete design state — inputs, loads, borehole layout, heat pump curves, base map, and energy cost rules. Simulation results are exported automatically to CSV whenever the project is saved.
Creating a new project - Select to start a fresh project. All inputs are reset to their default values and the current simulation results are cleared. If the current project has unsaved changes, GHE Analysis will prompt you to save before proceeding.
Saving a project - Select to write the project to its current location, or Save As to choose a new name or folder. The file dialog filters for GHE project (*.ghe) by default. If no file has been assigned yet, Save behaves like Save As.
The last folder used is remembered across sessions, so subsequent opens and saves start in the same directory.
Opening a project - Select Open to browse for a .ghe file. GHE Analysis reads the file, restores all inputs and settings, and re-triggers the simulation so that the console and charts reflect the saved state immediately. The file dialog filters for GHE project (*.ghe).
The .ghe project file - The .ghe extension is associated with the GHE Analysis application icon on Windows, so double-clicking a project file in Explorer opens it directly. A .ghe file is a compact binary archive (CBOR-encoded JSON) carrying the full project state:
- Simulation parameters — all entries of the internal parameter array (geometry, ground properties, fluid, boreholes).
- Thermal loads — hourly or monthly building loads as entered or imported.
- Heat pump performance — input mode, COP / CAP table.
- Borehole field — X, Y coordinates, azimuth and dip of every borehole, plus all GHE designer settings.
- Base map — the georeferenced background image, if one has been loaded.
- Project description — name, client, address, currency and general notes.
- Energy cost rules — all tariff rules, equipment presets and escalation rate.
Automatic exports on save - Each time a project is saved, GHE Analysis writes up to three files alongside the .ghe file (only if a completed simulation is available). The files are saved in the same directory as the .ghe file and contain:
| File | Content |
|---|---|
{project}.csv |
Hourly simulation results — one row per hour of the simulation horizon. |
{project}_EnergyCost.csv |
Hourly energy cost per source, with equipment and unit metadata. Written only when at least one tariff rule is defined. |
{project}.png |
Snapshot of the GHE designer canvas (borehole layout, base map, thermal plume). |
These files are overwritten each time the project is saved. They are suitable for import into spreadsheets or post-processing scripts.
Hourly simulation results - The hourly results file ({project}.csv) contains one header row followed by one row per simulated hour. Values are written with four decimal places. The number of rows equals the simulation duration in years × 8 760 hours. The columns are:
| Column | Unit | Description |
|---|---|---|
| Time | h | Hour index (1 to n × 8 760) |
| EFT | °C | Entering fluid temperature at the heat pump |
| QbC | kW | Building cooling load (≥ 0) |
| QbH | kW | Building heating load (≥ 0) |
| QDHW | kW | Domestic hot water demand (≥ 0) |
| Qb | kW | Net building load (− cooling, + heating) |
| Qg | kW | Net ground load (+ cooling, − heating) |
| QHP | kW | Load served by the heat pumps |
| QAux | kW | Load served by auxiliary equipment |
| PLR | — | Part-load ratio |
| COP | — | COP at EFT |
| CAP | kW | Installed capacity at EFT |
| RbEff | m·K/W | Effective borehole resistance |
| QDHWdemand | kW | DHW demand at this hour |
| QDHWcovered | kW | DHW actually covered by the heat pumps |