Complete language support to all GUI tabs

[Ski90Moo]

Wraps user-facing string literals with tr() across all major tabs and adds a complete Spanish (es) translation file as proof of concept for multi-language support, addressing issue #680.

Tabs covered: Site/Weather Data, Construction Sets, Materials, Schedules, Thermal Zones, Space Types, Loads, Facility, HVAC Systems, Inspector panel IDD fields, Output Variables (1051 names), Simulation Settings, Measures, Run Simulation, and Results Summary.

Key patterns established:

• tr() for compile-time strings in Q_OBJECT classes
• QCoreApplication::translate(IDD/OutputVariables/TaxonomyCategories) for runtime strings from the OpenStudio SDK and taxonomy.xml
• addItem(tr(Display), EnglishData) + currentData() for model-bound combo boxes where SDK values must stay in English
• Bilingual display format for IDD fields and output variable names so engineers can cross-reference EnergyPlus documentation without switching the application language

translations/OpenStudioApp_es.ts grows from ~200 to 3017 entries.
New languages only require a new .ts file with no further C++ changes.

The exception is the Geometry tab HTML files (geometry_editor_start.html and geometry_preview.html) each contain a hardcoded JavaScript dictionary keyed by locale code. We could:

Option A — Keep the Geometry tab HTML as an exception requiring separate edits.

Option B — Improve the architecture (better): Have the C++ side inject the locale into the HTML page at load time via QWebEnginePage::runJavaScript(), and move the translations out of the HTML into the .ts file.

Co-Authored-By: Claude Sonnet 4.6 noreply@anthropic.com

DView Units Conversion dialog

The "Would you like to display your Energy+ data in IP units?" dialog shown when opening DView for detailed reports is rendered by the dviewx64.exe binary (wxWidgets) and cannot be translated through Qt's .ts system.

A companion PR has been opened against the upstream wex library to add --ip/--si CLI flags to DView: NatLabRockies/wex#197

Once that PR merges and a new DView binary is deployed, the OpenStudio side will show its own translated Qt dialog and forward the user's answer to DView via CLI flag, bypassing DView's English-only prompt. The relevant code is already in place in ResultsTabView.cpp and commented out pending the new binary.

Extra testing required

• ScheduleFileInspector - especially the separator
• VariablesTab

[github-actions]

CLA Assistant Lite bot All contributors have signed the CLA ✍️ ✅

[Ski90Moo]

I have read the CLA Document and I hereby sign the CLA

[macumber]

This is awesome @Ski90Moo! I will check this out!

[Ski90Moo]

Thank you @macumber. It is rough, but a good start. I would like your feedback on the html issue.

[Copilot]

Pull request overview

This PR expands internationalization across the OpenStudio Application UI by wrapping user-facing strings with Qt translation APIs and adding a significantly more complete Spanish translation as a proof of concept (Issue #680). It also introduces tests to validate the .ts file structure/content and (optionally) runtime .qm translation loading.

Changes:

• Wrapped many GUI string literals in tr() / QCoreApplication::translate() across tabs, inspectors, and grid views.
• Added bilingual display formatting for SDK-driven names (eg. Output Variables, IDD fields) to show Translated (English) when non-English.
• Added a new translation-focused GTest suite and wired it into the app test target.

Reviewed changes

Copilot reviewed 98 out of 100 changed files in this pull request and generated 9 comments.

Show a summary per file

File	Description
src/shared_gui_components/WorkflowView.cpp	Translates “drop measure” placeholder text.
src/shared_gui_components/WorkflowController.cpp	Translates section headers for measure categories.
src/shared_gui_components/OSGridController.cpp	Translates “Custom” category label and apply-button text.
src/shared_gui_components/LocalLibraryView.cpp	Translates tooltips/button labels in the local library footer.
src/shared_gui_components/LocalLibraryController.cpp	Translates taxonomy category names at render time.
src/openstudio_lib/WindowMaterialSimpleGlazingSystemInspectorView.cpp	Translates inspector labels (and file gained a BOM).
src/openstudio_lib/WindowMaterialShadeInspectorView.cpp	Translates inspector labels (and file gained a BOM).
src/openstudio_lib/WindowMaterialScreenInspectorView.cpp	Translates inspector labels (and file gained a BOM).
src/openstudio_lib/WindowMaterialGlazingRefractionExtinctionMethodInspectorView.cpp	Translates inspector labels (and file gained a BOM).
src/openstudio_lib/WindowMaterialGlazingInspectorView.cpp	Translates inspector labels (and file gained a BOM).
src/openstudio_lib/WindowMaterialGasMixtureInspectorView.cpp	Translates inspector labels (and file gained a BOM).
src/openstudio_lib/WindowMaterialGasInspectorView.cpp	Translates inspector labels (and file gained a BOM).
src/openstudio_lib/WindowMaterialDaylightRedirectionDeviceInspectorView.cpp	Translates inspector labels (and file gained a BOM).
src/openstudio_lib/WindowMaterialBlindInspectorView.cpp	Translates inspector labels (and file gained a BOM).
src/openstudio_lib/WaterUseEquipmentInspectorView.cpp	Translates inspector labels (and file gained a BOM).
src/openstudio_lib/VRFGraphicsItems.cpp	Translates VRF drag/drop placeholder labels.
src/openstudio_lib/VariablesTabView.cpp	Adds translated+bilingual output variable display and localized frequency display with English data values.
src/openstudio_lib/ThermalZonesTabView.cpp	Translates main tab title.
src/openstudio_lib/ThermalZonesGridView.cpp	Translates grid headers/categories via QCoreApplication::translate.
src/openstudio_lib/SteamEquipmentInspectorView.cpp	Translates inspector labels (and file gained a BOM).
src/openstudio_lib/StandardsInformationMaterialWidget.cpp	Translates standards/measure-tags labels.
src/openstudio_lib/StandardsInformationConstructionWidget.cpp	Translates standards/measure-tags labels.
src/openstudio_lib/SpaceTypesTabView.cpp	Translates main tab title.
src/openstudio_lib/SpaceTypesGridView.cpp	Translates headers/categories/filter labels; some tooltips still hardcoded.
src/openstudio_lib/SpacesTabController.cpp	Translates spaces sub-tab titles.
src/openstudio_lib/SpacesSurfacesGridView.cpp	Translates grid headers/categories.
src/openstudio_lib/SpacesSubtabGridView.cpp	Translates filter labels; stores English keys in combo box data for SDK values.
src/openstudio_lib/SpacesSubsurfacesGridView.cpp	Translates grid headers/categories.
src/openstudio_lib/SpacesSpacesGridView.cpp	Translates grid headers/categories.
src/openstudio_lib/SpacesShadingGridView.cpp	Translates grid headers/categories.
src/openstudio_lib/SpacesLoadsGridView.cpp	Translates grid headers/categories.
src/openstudio_lib/SpacesInteriorPartitionsGridView.cpp	Translates grid headers/categories.
src/openstudio_lib/SimSettingsTabController.cpp	Translates “Simulation Settings” tab title.
src/openstudio_lib/ServiceWaterGridItems.cpp	Translates tooltips and drop-zone placeholder text.
src/openstudio_lib/ScriptsTabView.cpp	Translates “Measures” tab title and sync button strings.
src/openstudio_lib/SchedulesTabView.cpp	Translates schedules sub-tab title.
src/openstudio_lib/SchedulesTabController.cpp	Translates schedules sub-tab titles.
src/openstudio_lib/ScheduleSetInspectorView.cpp	Translates schedule set inspector section labels.
src/openstudio_lib/ScheduleOthersView.cpp	Translates “Schedule Others” type names returned to the list view.
src/openstudio_lib/ScheduleOthersController.cpp	Translates unsupported-action message text.
src/openstudio_lib/ScheduleFileInspectorView.cpp	Translates labels and attempts to translate separator choices (but bind() will overwrite).
src/openstudio_lib/ScheduleDialog.cpp	Translates dialog labels and “None/unitless” strings.
src/openstudio_lib/ScheduleDayView.hpp	Adds Q_DECLARE_TR_FUNCTIONS for QGraphicsItem subclasses to enable tr().
src/openstudio_lib/ScheduleDayView.cpp	Translates schedule day UI strings/tooltips and keyboard prompt text.
src/openstudio_lib/ScheduleConstantInspectorView.cpp	Translates labels (one includes leading whitespace in the source string).
src/openstudio_lib/ScheduleCompactInspectorView.cpp	Translates labels.
src/openstudio_lib/RunTabView.cpp	Translates run tab title, button/checkbox labels, and status text.
src/openstudio_lib/ResultsTabView.cpp	Translates Results UI labels and some report names; “Custom Report N” uses concatenation.
src/openstudio_lib/ResultsTabController.cpp	Translates “Results Summary” tab title.
src/openstudio_lib/RefrigerationGraphicsItems.cpp	Translates refrigeration drop-zone placeholder text.
src/openstudio_lib/PeopleInspectorView.cpp	Translates inspector labels (and file gained a BOM).
src/openstudio_lib/OtherEquipmentInspectorView.cpp	Translates inspector labels (and file gained a BOM).
src/openstudio_lib/OSItemSelectorButtons.cpp	Translates toolbar button tooltips.
src/openstudio_lib/OSDropZone.hpp	Changes default text arg to empty so ctor can apply translated default.
src/openstudio_lib/OSDropZone.cpp	Applies translated default “Drag From Library” when text is empty.
src/openstudio_lib/OSDocument.cpp	Translates left-side main tab button labels.
src/openstudio_lib/MaterialsView.cpp	Translates materials category names returned to list view.
src/openstudio_lib/MaterialRoofVegetationInspectorView.cpp	Translates inspector labels (and file gained a BOM).
src/openstudio_lib/MaterialNoMassInspectorView.cpp	Translates inspector labels (and file gained a BOM).
src/openstudio_lib/MaterialInspectorView.cpp	Translates inspector labels (and file gained a BOM).
src/openstudio_lib/MaterialAirGapInspectorView.cpp	Translates inspector labels (and file gained a BOM).
src/openstudio_lib/LuminaireInspectorView.cpp	Translates inspector labels (and file gained a BOM).
src/openstudio_lib/LoopLibraryDialog.cpp	Translates HVAC library dialog titles/buttons/system names.
src/openstudio_lib/LoadsView.cpp	Translates loads category names returned to list view.
src/openstudio_lib/LightsInspectorView.cpp	Translates inspector labels (and file gained a BOM).
src/openstudio_lib/library/geometry_editor_start.html	Adds an in-HTML Spanish translation dictionary + DOM rewrite for headings/paragraphs.
src/openstudio_lib/InternalMassInspectorView.cpp	Translates inspector labels (and file gained a BOM).
src/openstudio_lib/HVACSystemsTabView.cpp	Translates main tab title.
src/openstudio_lib/HVACSystemsController.cpp	Translates system selector entries and HVAC type labels; translates some drop-zone text.
src/openstudio_lib/HotWaterEquipmentInspectorView.cpp	Translates inspector labels (and file gained a BOM).
src/openstudio_lib/GridItem.cpp	Translates drop-zone placeholder and “Supply/Demand Equipment” labels.
src/openstudio_lib/GeometryTabController.cpp	Translates geometry tab title and sub-tab titles.
src/openstudio_lib/GeometryPreviewView.cpp	Injects locale into embedded web content; translates some UI strings.
src/openstudio_lib/GeometryEditorView.cpp	Injects locale into embedded editor; translates most UI strings and some dialogs.
src/openstudio_lib/GasEquipmentInspectorView.cpp	Translates inspector labels (and file gained a BOM).
src/openstudio_lib/FacilityTabView.cpp	Translates facility tab title.
src/openstudio_lib/FacilityTabController.cpp	Translates facility sub-tab titles.
src/openstudio_lib/FacilityStoriesGridView.cpp	Translates grid headers/categories and filter label.
src/openstudio_lib/FacilityShadingGridView.cpp	Translates grid headers/categories and uses English keys in filter combo data.
src/openstudio_lib/FacilityExteriorEquipmentGridView.cpp	Translates grid headers/categories and view titles.
src/openstudio_lib/ElectricEquipmentInspectorView.cpp	Translates inspector labels (and file gained a BOM).
src/openstudio_lib/ConstructionsView.cpp	Translates constructions category names returned to list view.
src/openstudio_lib/ConstructionsTabController.cpp	Translates constructions sub-tab titles and main tab title.
src/openstudio_lib/ConstructionInternalSourceInspectorView.cpp	Translates inspector labels and drop-zone text (and file gained a BOM).
src/openstudio_lib/ConstructionInspectorView.cpp	Translates inspector labels and drop-zone text.
src/openstudio_lib/ConstructionFfactorGroundFloorInspectorView.cpp	Translates inspector labels (and file gained a BOM).
src/openstudio_lib/ConstructionCfactorUndergroundWallInspectorView.cpp	Translates inspector labels (and file gained a BOM).
src/openstudio_lib/ConstructionAirBoundaryInspectorView.cpp	Translates inspector labels and comments (and file gained a BOM).
src/openstudio_lib/BuildingInspectorView.cpp	Translates building inspector labels.
src/openstudio_app/test/Translation_GTest.cpp	Adds tests to validate .ts content and optionally .qm runtime translation.
src/openstudio_app/CMakeLists.txt	Adds Translation_GTest.cpp to the test sources.
src/model_editor/InspectorGadget.cpp	Adds bilingual IDD field display names with runtime translation lookup.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Ski90Moo]

Thanks for flagging this @jmarrec — that's exactly the kind of subtle breakage that's hard to catch in review.

I did an exhaustive audit of every toStdString() and currentText() call added by this PR. Here's what I found:

tr().toStdString() calls (21 occurrences) — all are the second argument to addCheckBoxColumn / addSelectColumn, which is const std::string& tooltip. These feed the column header tooltip in the Qt grid widget, never the model SDK.

currentData().toString().toStdString() → model setter (3 occurrences):

• ScheduleFileInspectorView: m_sch->setColumnSeparator(m_columnSeparator->currentData().toString().toStdString()) — uses currentData() ✓
• VariablesTabView: m_variable->setReportingFrequency(m_combobox->currentData().toString().toStdString()) — uses currentData() ✓
• SpacesSubtabGridView filter comparisons: data = currentData().toString() then data.toStdString() used as a filter predicate against model getter values — not a setter ✓

UtilityBillsView translated fuel names (12 occurrences): std::pair<FuelType, std::string> where the translated string goes only to OSCollapsibleItemHeader (display label). The FuelType enum key is what reaches the model. ✓

currentText() == tr(...) comparisons (5 occurrences in GeometryEditorView and SpacesSubtabGridView): Used for UI branching (which editor class to show, whether to apply a filter). No model setter in the branch bodies. ✓

field == tr(...) column-type switch in FacilityExteriorEquipmentGridView (~30 occurrences): The translated string discriminates which addNameLineEditColumn / addParentNameLineEditColumn call to make. Model access goes through function pointers (&model::ModelObject::setName), never through the translated string itself. ✓

Zero instances of a translated string reaching an SDK model setter. The addItem(tr(display), QStringLiteral("EnglishData")) + currentData() pattern is used consistently wherever a combo drives a model write — this is also documented in translations/TRANSLATION_WORKFLOW.md as a required pattern.

[macumber]

I don't see translate_all_languages.py or fix_and_unvanish.py

[macumber]

These two are also missing?

[macumber]

This should not be necessary, all generated files should be in the build directory.

[macumber]

Is translate_new_languages.py missing?

[macumber]

Do you need to add these new translations to the list translations/CMakeLists.txt?