eSaver Ausw Ersparnis v1.02.3 packages

Auswertung Ersparnis v1.02.3 - (c) GMarder /eSaver GmbH
https://www.esaver.eu/

Motivation

Die Projektdaten werden derzeit in zwei unterschiedlichen VIDA-Datenerfassungen aufgezeichnet.

Für die Jahresauswertung müssen diese Daten zunächst in zwölf Monatsdateien aus dem VIDA-System exportiert werden.

Anschließend werden die enthaltenen Werte in eine Importdatei konvertiert und die Einheiten gegebenenfalls angepasst (z. B. Wh in kWh).

Die aufbereiteten Monatsdateien werden danach in die Jahresauswertung übernommen und dort in Excel weiterverarbeitet.

---

Funktionsablauf

Alle benötigten Dateinamen und Ablageorte werden in einer Excel-Datei definiert, über die anschließend die Konvertierung erfolgt.

Zur Überprüfung der Verbindung zum Python-Programm wurde ein Button integriert.
Bei erfolgreicher Verbindung wird eine entsprechende Rückmeldung ausgegeben.

Für die Verarbeitung der Daten stehen drei weitere Buttons zur Verfügung.
Nach erfolgreicher Ausführung kehrt der jeweilige Button automatisch in seine Ausgangsposition zurück.

---

---

Einstellungen in der Excel-Datei

Hinterlegen der Projektkennung

Parameter	Wert
Projektname	Name1-Name2
Projekttyp	G 63 M / 1000 kVA
Projektnummer	PJJ0X0XX
Datum	18.02.2026
Jahresübersicht	2025
Datum Start	01.01.2025
Datum Ende	31.12.2025

---

VIDA-Version und Ablageorte

Parameter	Wert
VIDA-Version	VIDA-SystemX
Export VIDA	Stundenverbrauch
Path Export Files	C:...\VIDA-Export-Path...\eSaver_Ausw_Erspar\example
Path Import Files	C:...\VIDA-Import-Path...\eSaver_Ausw_Erspar\example

Hinweis: Beide Pfade können identisch sein.

---

Export-Dateien

Parameter	Wert
Export_File_01_Jan	PJJ0X0XX Export_VIDA-Data_2025_0101_2025_0201_StdVerBer_GM.csv
Export_File_xx_mon	PJJ0X0XX Export_VIDA-Data_2025_xx01_2025_yy01_StdVerBer_GM.csv
Export_File_12_Jan	PJJ0X0XX Export_VIDA-Data_2025_1201_2025_1201_StdVerBer_GM.csv

→ Insgesamt 12 Dateien für die Jahresauswertung

---

Import-Dateien

Parameter	Wert
Import_File_01_Jan	PJJ0X0XX Import_VIDA-Data_2025_0101_2025_0201_StdVerBer_Imp.csv
Import_File_xx_mon	PJJ0X0XX Import_VIDA-Data_2025_xx01_2025_yy01_StdVerBer_Imp.csv
Import_File_12_Jan	PJJ0X0XX Import_VIDA-Data_2025_1201_2025_1201_StdVerBer_Imp.csv

→ Insgesamt 12 Dateien für die Jahresauswertung

---

Auswertungsdatei

Parameter	Wert
PJJ0X0XX_Ersparnis_File	PJJ0X0XX_Name1-Name2 Ersparnis 2025_01-12 - Stundenbasiert ID.xlsx

→ Die Datei wird im Verzeichnis Path_Import_Files erwartet

---

---

Bedienung der Excel-Datei

Zur Vereinfachung der Datenverarbeitung wurden entsprechende Bedienbuttons integriert.

Verbindung zu Python testen

• Button „Test Main“

Dieser ruft die Funktion xw_main_req auf und schreibt eine Rückmeldung in die Excel-Datei.

---

Verarbeitung der VIDA-Daten

Schritt 1: Initialisierung

• Funktion zur Vorbereitung der Importstruktur
• Export-Dateien werden eingelesen und in Import-Dateinamen umgewandelt

---

Schritt 2: Generierung der Importdateien

• Exportdateien werden eingelesen
• Werte werden geprüft und vereinheitlicht
• Importdateien werden erstellt

---

Schritt 3: Import in die Auswertung

• Importdateien werden eingelesen
• Daten werden geprüft
• Werte werden in die Auswertungsdatei übertragen

---

---

Programmstruktur

├── pyproject.toml
├── ... other config files ...
├── docs
│   ├── api_eS_Ausw_1_xlsm_Init_reads.md
│   ├── api_eS_Ausw_2_csv_to_excel_and_scan_kw.md
│   ├── api_eS_Ausw_2_xlsx_to_excel_and_scan_kw.md
│   ├── api_eS_Ausw_3_Imports_to_Ausw.md
│   ├── api_eS_Ausw_Erspar.md
│   ├── api_eS_Data_App.md
│   ├── api_eS_Data_XLS.md
│   ├── api.md
│   └── index.md
├── examples
├── ├── PJJ0X0XX_Empty
├── ├── ├── PJJ0X0XX Export_VIDA-Data_2025_xx01_2025_xx01_StdVerBer_GM.csv
├── ├── ├── "="  // Muster-Dateien ohne Werte
├── ├── └── ...
├── ├── PJJ0X0XX_Values
├── ├── ├── PJJ0X0XX Export_VIDA-Data_2025_xx01_2025_xx01_StdVerBer_GM.csv
├── ├── ├── "="  // Muster-Dateien mit Werten
├── ├── └── ...
│   ├── eSaver_Export_VIDA_Ausw_Erspar_SVB_PJJ0X0XX.xlsm
│   ├── PJJ0X0XX Export_VIDA-Data_2025_0101_2025_0101_StdVerBer_GM.csv
│   ├── PJJ0X0XX Export_VIDA-Data_2025_xx01_2025_xx01_StdVerBer_GM.csv
│   ├── PJJ0X0XX Export_VIDA-Data_2025_1201_2026_0101_StdVerBer_GM.csv
│   ├── PJJ0X0XX_Name1-Name2 Ersparnis 2025_01-12 - Stundenbasiert GMpk.xlsx
│   └── ...
├── src
│   ├── __init__.py
│   ├── eSaver_Ausw_1_xlsm_Init_reads.py
│   ├── eSaver_Ausw_2_csv_to_excel_and_scan_kw_v.py
│   ├── eSaver_Ausw_2_xlsx_to_excel_and_scan_kw_v.py
│   ├── eSaver_Ausw_3_excel_Imp_to_excel_Ausw.py
│   ├── eSaver_Data_App.py
│   └── eSaver_Data_XLS.py
└── tests
    ├── __init__.py
    └── test_eSaver_Data_App_pytest.py.py

Installation

# Build and Install (local)
pip install -e .

---

End of File

BSD 3-Clause License

Copyright (c) 2021-2026 by the eSaver GmbH

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.