ProjectTab package

Project Tab Module

Project management tab with MVP architecture for CSV file editing and project tracking.

author:

Dipl.-Ing. (FH) Jonas Pfeiffer

class districtheatingsim.gui.ProjectTab.project_tab.ProjectModel

Bases: object

Model for managing project data including CSV and GeoJSON file operations.

__init__()

load_csv(file_path)

Load CSV file data.

Parameters:

file_path (str) – Path to CSV file.

Returns:

Headers and data lists.

Return type:

tuple

save_csv(file_path, headers, data)

Save data to CSV file.

Parameters:

• file_path (str) – Output file path.

• headers (list) – Column headers.

• data (list of lists) – Table data.

create_csv(file_path, headers, default_data)

Create new CSV file with default data.

Parameters:

• file_path (str) – Output file path.

• headers (list) – Column headers.

• default_data (list) – Default row data.

create_csv_from_geojson(geojson_file_path, output_file_path, default_values, project_crs='EPSG:25833')

Create the building CSV from a GeoJSON (thin wrapper over the GUI-free districtheatingsim.geocoding.building_csv.geojson_to_building_csv()).

Parameters:

• geojson_file_path – Input GeoJSON file path.

• output_file_path – Output CSV file path.

• default_values – Default values for building parameters.

• project_crs – CRS of the GeoJSON coordinates.

Returns:

Output file path.

Return type:

str

calculate_centroid(coordinates)

Calculate centroid of a (possibly nested) coordinate array.

Thin wrapper over the GUI-free centroid_of().

Parameters:

coordinates (list) – Coordinate array.

Returns:

Centroid coordinates (x, y).

Return type:

tuple

class districtheatingsim.gui.ProjectTab.project_tab.ProjectPresenter(model, view, folder_manager, data_manager, config_manager)

Bases: object

Presenter managing interaction between ProjectModel and ProjectTabView.

__init__(model, view, folder_manager, data_manager, config_manager)

Initialize project presenter.

Parameters:

• model (ProjectModel) – Data model.

• view (ProjectTabView) – View component.

• folder_manager (object) – Folder manager.

• data_manager (object) – Data manager.

• config_manager (object) – Configuration manager.

connect_view_signals()

Connect view signals after view is created.

on_variant_folder_changed(path)

Handle project folder change.

Parameters:

path (str) – New project folder path.

on_tree_view_double_clicked(index)

Handle double-click on file tree view.

Parameters:

index (QModelIndex) – Tree view index.

import_csv()

Open a CSV file, show the column-mapping dialog, and load the result.

If the source CSV already uses the internal column schema (all required columns present with the expected names) it is loaded directly without showing the mapping dialog. Otherwise the CsvImportDialog is shown so the user can assign source columns to target fields and supply default values for missing ones.

load_csv(file_path)

Load CSV file into table view.

Parameters:

file_path (str) – Path to CSV file.

save_csv(show_dialog=True)

Save current table data to CSV file.

Parameters:

show_dialog (bool) – Show confirmation dialog if True.

add_row()

Add new empty row to table.

del_row()

Delete selected row from table.

create_csv(fname=None, show_dialog=True)

Create new CSV file with default building data headers.

Parameters:

• fname (str) – Optional file path.

• show_dialog (bool) – Show file dialog if True.

create_csv_from_geojson()

Create CSV from GeoJSON with user-defined building parameters.

on_geojson_conversion_progress(current, total, message)

Handle progress updates from GeoJSON conversion thread.

Parameters:

• current (int) – Current building number.

• total (int) – Total number of buildings.

• message (str) – Progress message.

on_geojson_conversion_done(output_file_path)

Handle completion of GeoJSON conversion.

Parameters:

output_file_path (str) – Path to created CSV file.

on_geojson_conversion_error(error_message)

Handle error during GeoJSON conversion.

Parameters:

error_message (str) – Error message.

geocode_current_csv()

Geocode the currently loaded CSV file.

open_geocode_addresses_dialog()

Open file dialog for geocoding CSV selection.

geocode_addresses(inputfilename)

Start geocoding thread for address processing.

Parameters:

inputfilename (str) – Path to CSV file for geocoding.

on_geocode_done(result)

Handle geocoding completion.

Parameters:

result (tuple) – Tuple of (filename, summary_dict) emitted by GeocodingThread.

on_geocode_error(error_message)

Handle geocoding errors.

Parameters:

error_message (str) – Error message to display.

update_progress(progress, csv_status=None)

Update progress bar value and CSV status label.

Parameters:

• progress (float) – Progress percentage.

• csv_status (str) – Status text for Quartier IST.csv.

check_csv_status(csv_file_path)

Check detailed CSV status: missing, available without coordinates, or with coordinates.

Parameters:

csv_file_path (str) – Path to CSV file to check.

Returns:

Status: ‘fehlt’, ‘ist vorhanden’, or ‘mit Koordinaten’.

Return type:

str

check_network_dimensioned(network_file_path)

Check if network GeoJSON has state set to “dimensioned”.

Parameters:

network_file_path (str) – Path to Wärmenetz.geojson file.

Returns:

True if network is dimensioned, False otherwise.

Return type:

bool

update_progress_tracker()

Update project progress and CSV status label based on file existence and content.

class districtheatingsim.gui.ProjectTab.project_tab.ProjectTabView(presenter=None, parent=None)

Bases: QWidget

View component for project tab UI with file browser and CSV editor.

__init__(presenter=None, parent=None)

Initialize project tab view.

Parameters:

• presenter (ProjectPresenter) – Presenter instance for signal connections.

• parent (QWidget) – Parent widget.

initUI()

Initialize user interface components.

set_crs(crs: str)

Set the CRS combo box to the given EPSG code (blocks signal to avoid loop).

Parameters:

crs (str) – EPSG code string, e.g. "EPSG:25833"

get_crs() → str

Return the currently selected EPSG code string.

update_tree_view(path)

Update file tree view root path.

Parameters:

path (str) – New root path.

show_context_menu(position)

Show table context menu.

Parameters:

position (QPoint) – Menu position.

add_row()

Add new table row with input dialog.

delete_row()

Delete selected table row.

duplicate_row()

Duplicate selected table row.

get_selected_file_path(index)

Get selected file path from tree view.

Parameters:

index (QModelIndex) – Tree view index.

Returns:

Selected file path.

Return type:

str

show_error_message(title, message)

Display error message dialog.

Parameters:

• title (str) – Dialog title.

• message (str) – Error message.

update_progress(progress, csv_status=None)

Update progress bar value and CSV status label with color-coded status.

Parameters:

• progress (float) – Progress percentage.

• csv_status (str) – Status text for Quartier IST.csv.

showDetailsDialog()

Show process step details dialog.

set_process_steps(process_steps)

Set process steps data for details dialog.

Parameters:

process_steps (list) – List of process step dictionaries.

show_message(title, message)

Display information message dialog.

Parameters:

• title (str) – Dialog title.

• message (str) – Information message.

class districtheatingsim.gui.ProjectTab.project_tab.ProjectTab(folder_manager, data_manager, config_manager, parent=None)

Bases: QWidget

Main project tab widget integrating MVP components.

Note

Central interface for project management with file operations and progress tracking functionality.

__init__(folder_manager, data_manager, config_manager, parent=None)

Initialize project tab with MVP architecture.

Parameters:

• folder_manager (object) – Folder manager.

• data_manager (object) – Data manager.

• config_manager (object) – Configuration manager.

• parent (QWidget) – Parent widget.

Project Tab Dialogs Module

Dialog windows for project tab functionality including data input and progress display.

author:

Dipl.-Ing. (FH) Jonas Pfeiffer

class districtheatingsim.gui.ProjectTab.project_tab_dialogs.RowInputDialog(headers, parent=None)

Bases: QDialog

Dialog for adding new table rows with input fields.

__init__(headers, parent=None)

Initialize row input dialog.

Parameters:

• headers (list) – Column headers for input fields.

• parent (QWidget) – Parent widget.

get_input_data()

Get input data from dialog fields.

Returns:

Mapping of headers to input values.

Return type:

dict

class districtheatingsim.gui.ProjectTab.project_tab_dialogs.OSMImportDialog(parent=None, sample_utm_coords=None, project_crs: str = 'EPSG:25833')

Bases: QDialog

Dialog for OSM data import with default building parameters.

__init__(parent=None, sample_utm_coords=None, project_crs: str = 'EPSG:25833')

Initialize OSM import dialog.

Parameters:

• parent (QWidget) – Parent widget.

• sample_utm_coords (tuple) – Sample (UTM_X, UTM_Y) coordinates for reverse geocoding.

• project_crs (str) – Projected CRS of the sample coordinates.

get_input_data()

Get OSM import parameters.

Returns:

Mapping of parameters to input values.

Return type:

dict

class districtheatingsim.gui.ProjectTab.project_tab_dialogs.ProcessDetailsDialog(process_steps, parent=None)

Bases: QDialog

Dialog displaying detailed project progress information.

__init__(process_steps, parent=None)

Initialize process details dialog.

Parameters:

• process_steps (list) – List of process step dictionaries with progress info.

• parent (QWidget) – Parent widget.

get_step_progress(step)

Calculate step completion percentage based on required files.

Parameters:

step (dict) – Process step information.

Returns:

Completion percentage (0-100).

Return type:

float

get_status_text(status)

Get human-readable status text.

Parameters:

status (str) – Status code.

Returns:

Human-readable status text.

Return type:

str

get_status_color(status)

Get color for status display.

Parameters:

status (str) – Status code.

Returns:

CSS color value.

Return type:

str

class districtheatingsim.gui.ProjectTab.project_tab_dialogs.BuildingCSVDialog(headers, data=None, parent=None)

Bases: QDialog

Dialog for tabular input and editing of Quartier IST.csv building data.

__init__(headers, data=None, parent=None)

Initialize dialog for building CSV creation/editing.

Parameters:

• headers (list) – Column headers for table.

• data (list of lists) – Initial table data.

• parent (QWidget) – Parent widget.

initUI()

Initialize user interface components.

add_row()

Add new row to table.

del_row()

Delete selected row from table.

get_table_data()

Get table data as list of lists.

Returns:

Table data.

Return type:

list of lists