Regbot GUI: Difference between revisions

From Rsewiki
No edit summary
 
(13 intermediate revisions by the same user not shown)
Line 6: Line 6:
== Install Python ==
== Install Python ==


On a windows computer:
Install python and the python install program pip.


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


On a Linux computer, install pip (Python install program)
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
  sudo apt install pip


In the command window, start python
== Install Python packages ==
python
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.
=== Windows ===


If not installed, then install from Microsoft store, you will probably be directed directly, if not installed.
Open a terminal window (search for 'cmd' app)


=== Install packages ===
At the command prompt install these packages:


At the CMD prompt, install:
> pip install pyqt4
 
  > pip install pyserial
  > pip install pyqt5
  > 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:
There are two options
* Get the python files from a zip-file (available in Learn)
* Get the newest version from repository (SVN)


Install TortoiseSVN from https://subversion.apache.org
=== From zip file ===
On left menu find "Binary packages" and from here the 'Windows' section


* Download TortoiseSVN
Unzip the Python files (many files (23), so keep them in a clean directory).
* Install, and remember to add 'command line' support.
* restart a 'cmd' terminal after installation


=== Get the GUI (SVN repository) ===
=== From SVN repository ===


The file-browser may have support for SVN (or it can be added), in this case 'checkout' the regbot_gui on this address
Make sure your PC has SVN (Apache subversion) support.


svn://repos.gbar.dtu.dk/jcan/regbot/regbot_gui
===== Windows =====


On Linux (and maybe Apple) install subversion (Linux: sudo apt install subversion)
Install e.g. SilkSVN (https://sliksvn.com/download/), this is a command-line interface, but there are other packages too.


The checkout with the command
Start a 'cmd' terminal after installation.


svn checkout svn://repos.gbar.dtu.dk/jcan/regbot/regbot_gui
===== Linux (and MAC) =====


=== Get the GUI (GIT repository) ===
sudo apt install subversion


A snapshot of the GUI is provided for Teensy version 1535 (14 February 2023) in a git repository
==== Get the GUI Python files ====


Find the repository and the python files here
Open a terminal window, change the directory, to where you want to install, e.g. called 'svn'


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


git clone https://repos.gbar.dtu.dk/git/jcan/regbot_gui.git
There should be several Python files, including 'regbot.py'.


NB! The SVN repository is regularly updated and this GIT version may be outdated.
== Start the Regbot GUI ==


== Run the GUI ==
Go to the directory, where the Python files are placed.


=== The python version ===
* Execute the 'regbot.py' file.


In the regbot_gui directory, run the regbot.py script.
From a terminal
 
* On Linux, this command line should work:


  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 14:02, 7 December 2023

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)

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

Install Python packages

Windows

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

At the command prompt install these packages:

> pip install pyqt4
> 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