A GUI for Trnsys
Project description
Graphical user interface for pytrnsys
Overview
A short presentation (15 min) of pytrnsys and its features can be found in the following YouTube video.
Documentation
You can find the documentation under https://pytrnsys.readthedocs.io/
Installation
In the following all commands should be run from the pytrnsys_gui
directory. The command should be run in a
"Windows Command Prompt" for Windows environment. The commands should be very similar should you wish to install on
Linux.
Binary installation / User installation
Prerequisites
Required
Getting started
-
Open a command prompt (e.g., by hitting the Windows-key, then typing "cmd" into the search box and hitting enter). The following commands should be entered into the command prompt just opened.
-
Navigate to the directory which should contain the
pytrnsys-gui
directory:cd [your-directory]
Replace
[your-directory]
(including the brackets []) with your directory of choice: if your directory is calledfoo
thenpytrnsys-gui
will be installed tofoo\pytrnsys-gui
. -
Create a virtual environment:
py -3.9 -m venv pytrnsys-gui
-
Activate it:
pytrnsys-gui\Scripts\activate
-
Install the
wheel
package:pip install wheel
-
Install
pytrnsys-gui
and its requirements:pip install -r https://raw.githubusercontent.com/SPF-OST/pytrnsys_gui/v0.10.1-reqs/requirements/release.txt
You can now close the command prompt opened in the first step.
Several original types are delivered with pytrnsys. For those you'll manually need to copy the dll-files from:
pytrnsys-gui\pytrnsys_data\ddcks\dlls
to the respective folder of your TRNSYS installation:
...\UserLib\ReleaseDLLs
The pytrnsys-gui
can now be started by double-clicking on the
pytrnsys-gui\Scripts\pytrnsys-gui.exe
file. Example projects can be found in the
pytrnsys-gui\pytrnsys_gui_data\examples
directory.
Upgrading from one patch version to the next within the same minor version
There is a shortcut for upgrading from one patch version to the next within the same minor version, e.g., from 1.2.11 to 1.2.12:
- Activate your virtual environment:
pytrnsys-gui\Scripts\activate
- Issue the following command:
pip install --upgrade pytrnsys-gui
This method might not be 100% reliable. If you're experiencing problems, we recommend installing your preferred version from scratch as described above.
Installation from source / Developer installation
Prerequisites
Required
-
Local clones of the following GIT repositories:
https://github.com/SPF-OST/pytrnsys.git
https://github.com/SPF-OST/pytrnsys_gui.git
They should be next to each other and be called
pytrnsys
andpytrnsys_gui
like so:parent/ pytrnsys/ pytrnsys_gui/
Recommended
Getting started
All the following commands should be run from the pytrnsys_gui
directory. The commands
specified are for a Windows environment. They are very similar for Linux.
- Create a virtual environment:
py -3.9 -m venv venv
- Activate it:
venv\Scripts\activate
- Install the requirements:
pip install wheel python -m pip install -r requirements\dev.txt
- Generate Python files from the include Qt creator files:
python dev-tools\generateGuiClassesFromQtCreatorStudioUiFiles.py
- Tag the editable install of
pytrnsys-gui
setup.py egg_info -b dev
(By adding this tag we make sure that the Qt Creator .ui files are re-generated each time the GUI is started.) - Now you can run
pytrnsys-gui
!cd trnsysGUI python GUI.py
Several original types are delivered with pytrnsys. For those you'll manually need to copy the dll-files from:
pytrnsys\data\ddcks\dlls
to the respective folder of your TRNSYS installation:
...\UserLib\ReleaseDLLs
Beware that the GUI can only be started from within the virtual environment you created in step 1. I.e., whenever you open a new console window from which you want to start the GUI you first need to activate the environment (step 2. above).
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pytrnsys_gui-0.10.15-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0199eabbb12a560631c455d344f3d3ab0a44647bab4df97fac0d5af2a5772e63 |
|
MD5 | 6ee090346166f4b2b6803dc097e3d2f3 |
|
BLAKE2b-256 | ae0e5096207cf99075489e32740f3534f7e5155e244ca5406d54dd819510d5e0 |