Regbot GUI: Difference between revisions

From Rsewiki
 
(17 intermediate revisions by the same user not shown)
Line 1: Line 1:
Back to [[Regbot]]
Back to [[Regbot]]


Back to [[Robobot]]
== Install Python ==
 
Install python and the python install program pip.
 
=== Windows ===


Install Python from Microsoft store (Includes pip).
(Should be python version 3.x)


== Install Python ==
=== Mac ===


On a windows computer:
Install Python (version 3.x)
Maybe it is installed by default
(I have no MAC)


Start the command window by searching for 'cmd' after pressing the windows button.
=== Linux ===


On a Linux computer, install pip (Python install program)
install pip (Python Install Program)


sudo apt install python3
  sudo apt install pip
  sudo apt install pip


In the command window, start python
To be consistent, either use a virtual environment and install with pip, or
python
install packages with apt:
Python 3.6.9 (default, Oct  8 2020, 12:12:24)
on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> quit()


This should start python and write the version number. Version must be 3.X.X.
sudo apt install python3-pyqt5
sudo apt install python3-serial
sudo apt install python3-pyqtgraph


If not installed, then install from Microsoft store, you will probably be directed directly, if not installed.
== Install Python packages ==


=== Install packages ===
=== Windows ===


At the CMD prompt, install:
Open a terminal window (search for 'cmd' app)
 
At the command prompt install these packages:


  > pip install pyqt5
  > pip install pyqt5
> pip install pyserial
  > pip install pyqtgraph
  > pip install pyqtgraph
  > pip install pyserial
  > pip install numpy


If everything goes well, then you are ready to run the GUI from the Python script.
=== MAC ===


==== Linux (or Apple)====
The same packages are needed.


If you run Linux, the above are the packages you need here too.
=== Linux ===


I haven't tested on Apple, but maybe.
> pip install pyqt5
> pip install pyqtgraph
> pip install pyserial
> pip install numpy


== Get REGBOT GUI ==
== Get REGBOT GUI ==


===Install SVN=== 
The REGBOT GUI is just a set of python files
 
The source is on a SVN repository, if not available, then install:


Install TortoiseSVN from https://subversion.apache.org
There are two options
On left menu find "Binary packages" and from here the 'Windows' section
* Get the python files from a zip-file (available in Learn)
* Get the newest version from repository (SVN)


* Download TortoiseSVN
=== From zip file ===
* Install, and remember to add 'command line' support.
* restart a 'cmd' terminal after installation


=== Get the GUI (SVN repository) ===
Unzip the Python files (many files (23), so keep them in a clean directory).


The file-browser may have support for SVN (or it can be added), in this case 'checkout' the regbot_gui on this address
=== From SVN repository ===


svn://repos.gbar.dtu.dk/jcan/regbot/regbot_gui
Make sure your PC has SVN (Apache subversion) support.


On Linux (and maybe Apple) install subversion (Linux: sudo apt install subversion)
===== Windows =====


The checkout with the command
Install e.g. SilkSVN (https://sliksvn.com/download/), this is a command-line interface, but there are other packages too.


svn checkout svn://repos.gbar.dtu.dk/jcan/regbot/regbot_gui
Start a 'cmd' terminal after installation.


=== Get the GUI (GIT repository) ===
===== Linux (and MAC) =====


A snapshot of the GUI is provided for Teensy version 1535 (14 February 2023) in a git repository
sudo apt install subversion


Find the repository and the python files here
==== Get the GUI Python files ====


https://repos.gbar.dtu.dk/git/jcan/regbot_gui.git
Open a terminal window, change the directory, to where you want to install, e.g. called 'svn'


Copy files or clone to your disk
mkdir svn
 
cd svn
  git clone https://repos.gbar.dtu.dk/git/jcan/regbot_gui.git
  svn checkout svn://repos.gbar.dtu.dk/jcan/regbot/regbot_gui
cd regbot_gui


NB! The SVN repository is regularly updated and this GIT version may be outdated.
There should be several Python files, including 'regbot.py'.


== Run the GUI ==
== Start the Regbot GUI ==


=== The python version ===
Go to the directory, where the Python files are placed.


In the regbot_gui directory, run the regbot.py script.
* Execute the 'regbot.py' file.


* On Linux, this command line should work:
From a terminal


  cd regbot_gui
  cd regbot_gui
  python3 regbot.py
  python3 regbot.py
* On Windows
Find the directory in your file browser (Stifinder)
Start the file 'regbot.py' - maybe create a shortcut on the desktop.
If there are errors about libraries, then check if they are installed (from the list above).
=== Regbot.exe for Windows ===
A windows executable is generated (using the instructions below); this is found in a subdirectory called "dist".
> cd Downloads
> cd regbot
> cd regbot_gui
> cd dist
> regbot
Use the browser to locate the file and execute it.
It also holds all the needed python-libraries, so it takes a long time to start.
The regbot.exe file is made on a Windows 10 (I don't have anything newer if there are problems; revert to the Python version)
NB! the version from 2022 does not work anymore; it has to have a date from 2023.
=== Regbot GUI use===
See the [[User interface]]
== Make a windows EXE file ==
If you installed all the python stuff, you don't need the exe file.
To make a single exe-file without the need to install anything, then it is a bit more complicated (for me at least)
===Install python===
* Install python (tested with version 3.8) from https://www.python.org/downloads/ - select 'all users' in install options and also select 'add to path'.
After installation, start 'cmd' terminal windows as administrator (right-click on 'cmd' and select 'as administrator') to install additional packages using 'pip'.
> pip install pyqt5
> pip install pyqtgraph
> pip install pyserial
> pip install pyinstaller
> exit
Open a 'cmd' terminal window as a normal user
Then make the EXE-file from the directory with the REGBOT GUI
> cd Downloads\regbot_gui
> pyinstaller --onefile regbot.py
This takes some time, and the regbot.exe should be found in a 'dist' subdirectory.
Try:
> cd dist
> regbot.exe
PS! tried also with Python 3.9, but regbot.exe failed with the error: "PyQt5.sip not found".

Latest revision as of 11:24, 29 October 2025

Back to Regbot

Install Python

Install python and the python install program pip.

Windows

Install Python from Microsoft store (Includes pip). (Should be python version 3.x)

Mac

Install Python (version 3.x) Maybe it is installed by default (I have no MAC)

Linux

install pip (Python Install Program)

sudo apt install python3
sudo apt install pip

To be consistent, either use a virtual environment and install with pip, or install packages with apt:

sudo apt install python3-pyqt5
sudo apt install python3-serial
sudo apt install python3-pyqtgraph

Install Python packages

Windows

Open a terminal window (search for 'cmd' app)

At the command prompt install these packages:

> pip install pyqt5
> pip install pyserial
> pip install pyqtgraph
> pip install numpy

MAC

The same packages are needed.

Linux

> pip install pyqt5
> pip install pyqtgraph
> pip install pyserial
> pip install numpy

Get REGBOT GUI

The REGBOT GUI is just a set of python files

There are two options

  • Get the python files from a zip-file (available in Learn)
  • Get the newest version from repository (SVN)

From zip file

Unzip the Python files (many files (23), so keep them in a clean directory).

From SVN repository

Make sure your PC has SVN (Apache subversion) support.

Windows

Install e.g. SilkSVN (https://sliksvn.com/download/), this is a command-line interface, but there are other packages too.

Start a 'cmd' terminal after installation.

Linux (and MAC)

sudo apt install subversion

Get the GUI Python files

Open a terminal window, change the directory, to where you want to install, e.g. called 'svn'

mkdir svn
cd svn
svn checkout svn://repos.gbar.dtu.dk/jcan/regbot/regbot_gui
cd regbot_gui

There should be several Python files, including 'regbot.py'.

Start the Regbot GUI

Go to the directory, where the Python files are placed.

  • Execute the 'regbot.py' file.

From a terminal

cd regbot_gui
python3 regbot.py