Add automated setup and run scripts for Virtual Environment support
- setup.sh / setup.bat: Create venv, install dependencies - run.sh / run.bat: Activate venv and start main.py - .gitignore: Exclude venv, cache, IDE files - README.md: Updated installation guide with PEP 668 solution
This commit is contained in:
Developer
parent
27489a1d94
commit
486f166462
|
|
@ -0,0 +1,32 @@
|
||||||
|
# Virtual Environment
|
||||||
|
venv/
|
||||||
|
env/
|
||||||
|
.venv/
|
||||||
|
|
||||||
|
# Python Cache
|
||||||
|
__pycache__/
|
||||||
|
*.py[cod]
|
||||||
|
*$py.class
|
||||||
|
*.pyo
|
||||||
|
|
||||||
|
# IDE
|
||||||
|
.idea/
|
||||||
|
.vscode/
|
||||||
|
*.swp
|
||||||
|
*.swo
|
||||||
|
*~
|
||||||
|
|
||||||
|
# OS
|
||||||
|
.DS_Store
|
||||||
|
Thumbs.db
|
||||||
|
|
||||||
|
# Output files
|
||||||
|
output/*.cor
|
||||||
|
output/*.csv
|
||||||
|
output/*.txt
|
||||||
|
output/*.dxf
|
||||||
|
|
||||||
|
# Temporary files
|
||||||
|
*.tmp
|
||||||
|
*.temp
|
||||||
|
*.bak
|
||||||
119
README.md
119
README.md
|
|
@ -52,36 +52,119 @@ Ein vollständiges Python-Programm mit grafischer Benutzeroberfläche (GUI) für
|
||||||
- Export der transformierten JXL-Datei
|
- Export der transformierten JXL-Datei
|
||||||
- Validierung der Eingaben mit Warnungen bei problematischen Werten
|
- Validierung der Eingaben mit Warnungen bei problematischen Werten
|
||||||
|
|
||||||
## Installation
|
## Installation und Start
|
||||||
|
|
||||||
### Voraussetzungen
|
### Voraussetzungen
|
||||||
- Python 3.8 oder höher
|
- Python 3.8 oder höher
|
||||||
- PyQt5
|
- PyQt5, NumPy, SciPy, lxml
|
||||||
- NumPy
|
|
||||||
- SciPy
|
|
||||||
- lxml
|
|
||||||
|
|
||||||
### Installation der Abhängigkeiten
|
### Wichtiger Hinweis: Externally-Managed-Environment (PEP 668)
|
||||||
|
|
||||||
**Option 1: Mit requirements.txt (empfohlen)**
|
Moderne Linux-Distributionen (Ubuntu 23.04+, Debian 12+, Fedora 38+) verwenden ein "externally-managed-environment". Das bedeutet, dass `pip install` ohne Virtual Environment folgenden Fehler erzeugt:
|
||||||
```bash
|
|
||||||
cd /home/ubuntu/trimble_geodesy
|
```
|
||||||
pip install -r requirements.txt
|
error: externally-managed-environment
|
||||||
|
× This environment is externally managed
|
||||||
```
|
```
|
||||||
|
|
||||||
**Option 2: Manuelle Installation**
|
**Lösung:** Verwenden Sie ein Virtual Environment (empfohlen) oder die automatischen Setup-Scripts.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Methode 1: Automatische Installation (empfohlen)
|
||||||
|
|
||||||
|
#### Linux / macOS
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
pip install PyQt5 numpy scipy lxml
|
cd /home/ubuntu/trimble_geodesy
|
||||||
|
|
||||||
|
# 1. Setup ausführen (einmalig)
|
||||||
|
./setup.sh
|
||||||
|
|
||||||
|
# 2. Programm starten
|
||||||
|
./run.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
Falls `./setup.sh` nicht ausführbar ist:
|
||||||
|
```bash
|
||||||
|
chmod +x setup.sh run.sh
|
||||||
|
./setup.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
#### Windows
|
||||||
|
|
||||||
|
```cmd
|
||||||
|
cd C:\Pfad\zum\trimble_geodesy
|
||||||
|
|
||||||
|
REM 1. Setup ausführen (einmalig)
|
||||||
|
setup.bat
|
||||||
|
|
||||||
|
REM 2. Programm starten
|
||||||
|
run.bat
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Methode 2: Manuelle Installation mit Virtual Environment
|
||||||
|
|
||||||
|
#### Linux / macOS
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd /home/ubuntu/trimble_geodesy
|
||||||
|
|
||||||
|
# Virtual Environment erstellen
|
||||||
|
python3 -m venv venv
|
||||||
|
|
||||||
|
# Virtual Environment aktivieren
|
||||||
|
source venv/bin/activate
|
||||||
|
|
||||||
|
# Abhängigkeiten installieren
|
||||||
|
pip install -r requirements.txt
|
||||||
|
|
||||||
|
# Programm starten
|
||||||
|
python3 main.py
|
||||||
|
```
|
||||||
|
|
||||||
|
#### Windows
|
||||||
|
|
||||||
|
```cmd
|
||||||
|
cd C:\Pfad\zum\trimble_geodesy
|
||||||
|
|
||||||
|
REM Virtual Environment erstellen
|
||||||
|
python -m venv venv
|
||||||
|
|
||||||
|
REM Virtual Environment aktivieren
|
||||||
|
venv\Scripts\activate.bat
|
||||||
|
|
||||||
|
REM Abhängigkeiten installieren
|
||||||
|
pip install -r requirements.txt
|
||||||
|
|
||||||
|
REM Programm starten
|
||||||
|
python main.py
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fehlerbehebung
|
||||||
|
|
||||||
|
**Fehler: `python3-venv` nicht installiert (Linux)**
|
||||||
|
```bash
|
||||||
|
sudo apt install python3-venv # Ubuntu/Debian
|
||||||
|
sudo dnf install python3-venv # Fedora
|
||||||
|
```
|
||||||
|
|
||||||
|
**Fehler: Permission denied bei setup.sh**
|
||||||
|
```bash
|
||||||
|
chmod +x setup.sh run.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
**Fehler: Qt-Plattform nicht gefunden**
|
||||||
|
```bash
|
||||||
|
sudo apt install libxcb-xinerama0 libxcb-cursor0 # Ubuntu/Debian
|
||||||
```
|
```
|
||||||
|
|
||||||
## Verwendung
|
## Verwendung
|
||||||
|
|
||||||
### Programm starten
|
|
||||||
```bash
|
|
||||||
cd /home/ubuntu/trimble_geodesy
|
|
||||||
python3 main.py
|
|
||||||
```
|
|
||||||
|
|
||||||
### Workflow
|
### Workflow
|
||||||
1. **JXL-Analyse Tab**: JXL-Datei laden und analysieren
|
1. **JXL-Analyse Tab**: JXL-Datei laden und analysieren
|
||||||
2. **COR-Generator Tab**: Koordinaten generieren und exportieren
|
2. **COR-Generator Tab**: Koordinaten generieren und exportieren
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,31 @@
|
||||||
|
@echo off
|
||||||
|
REM
|
||||||
|
REM Trimble Geodesy Tool - Run Script (Windows)
|
||||||
|
REM Aktiviert das Virtual Environment und startet das Programm
|
||||||
|
REM
|
||||||
|
|
||||||
|
REM Wechsle ins Script-Verzeichnis
|
||||||
|
cd /d "%~dp0"
|
||||||
|
|
||||||
|
REM Pruefe ob Virtual Environment existiert
|
||||||
|
if not exist venv (
|
||||||
|
echo X Fehler: Virtual Environment nicht gefunden.
|
||||||
|
echo.
|
||||||
|
echo Bitte zuerst setup.bat ausfuehren
|
||||||
|
echo.
|
||||||
|
pause
|
||||||
|
exit /b 1
|
||||||
|
)
|
||||||
|
|
||||||
|
REM Aktiviere Virtual Environment
|
||||||
|
call venv\Scripts\activate.bat
|
||||||
|
|
||||||
|
if %ERRORLEVEL% neq 0 (
|
||||||
|
echo X Fehler beim Aktivieren des Virtual Environments
|
||||||
|
pause
|
||||||
|
exit /b 1
|
||||||
|
)
|
||||||
|
|
||||||
|
REM Starte das Programm
|
||||||
|
echo Starte Trimble Geodesy Tool...
|
||||||
|
python main.py
|
||||||
|
|
@ -0,0 +1,30 @@
|
||||||
|
#!/bin/bash
|
||||||
|
#
|
||||||
|
# Trimble Geodesy Tool - Run Script (Linux/macOS)
|
||||||
|
# Aktiviert das Virtual Environment und startet das Programm
|
||||||
|
#
|
||||||
|
|
||||||
|
# Wechsle ins Script-Verzeichnis
|
||||||
|
cd "$(dirname "$0")"
|
||||||
|
|
||||||
|
# Prüfe ob Virtual Environment existiert
|
||||||
|
if [ ! -d "venv" ]; then
|
||||||
|
echo "❌ Fehler: Virtual Environment nicht gefunden."
|
||||||
|
echo ""
|
||||||
|
echo " Bitte zuerst setup.sh ausführen:"
|
||||||
|
echo " ./setup.sh"
|
||||||
|
echo ""
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Aktiviere Virtual Environment
|
||||||
|
source venv/bin/activate
|
||||||
|
|
||||||
|
if [ $? -ne 0 ]; then
|
||||||
|
echo "❌ Fehler beim Aktivieren des Virtual Environments"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Starte das Programm
|
||||||
|
echo "Starte Trimble Geodesy Tool..."
|
||||||
|
python3 main.py
|
||||||
|
|
@ -0,0 +1,87 @@
|
||||||
|
@echo off
|
||||||
|
REM
|
||||||
|
REM Trimble Geodesy Tool - Setup Script (Windows)
|
||||||
|
REM Erstellt ein Virtual Environment und installiert alle Abhängigkeiten
|
||||||
|
REM
|
||||||
|
|
||||||
|
echo ========================================
|
||||||
|
echo Trimble Geodesy Tool - Setup
|
||||||
|
echo ========================================
|
||||||
|
echo.
|
||||||
|
|
||||||
|
REM Wechsle ins Script-Verzeichnis
|
||||||
|
cd /d "%~dp0"
|
||||||
|
|
||||||
|
REM Pruefe ob Python installiert ist
|
||||||
|
python --version >nul 2>&1
|
||||||
|
if %ERRORLEVEL% neq 0 (
|
||||||
|
echo X Fehler: Python ist nicht installiert.
|
||||||
|
echo Bitte installieren Sie Python von https://python.org
|
||||||
|
echo Wichtig: Bei der Installation "Add Python to PATH" aktivieren!
|
||||||
|
pause
|
||||||
|
exit /b 1
|
||||||
|
)
|
||||||
|
|
||||||
|
echo [OK] Python gefunden
|
||||||
|
|
||||||
|
REM Erstelle Virtual Environment
|
||||||
|
echo.
|
||||||
|
echo -^> Erstelle Virtual Environment...
|
||||||
|
|
||||||
|
if exist venv (
|
||||||
|
echo Virtual Environment existiert bereits.
|
||||||
|
set /p REPLY=" Neu erstellen? (j/n): "
|
||||||
|
if /i "%REPLY%"=="j" (
|
||||||
|
rmdir /s /q venv
|
||||||
|
python -m venv venv
|
||||||
|
echo [OK] Virtual Environment neu erstellt
|
||||||
|
)
|
||||||
|
) else (
|
||||||
|
python -m venv venv
|
||||||
|
echo [OK] Virtual Environment erstellt
|
||||||
|
)
|
||||||
|
|
||||||
|
REM Aktiviere Virtual Environment
|
||||||
|
echo.
|
||||||
|
echo -^> Aktiviere Virtual Environment...
|
||||||
|
call venv\Scripts\activate.bat
|
||||||
|
|
||||||
|
if %ERRORLEVEL% neq 0 (
|
||||||
|
echo X Fehler beim Aktivieren des Virtual Environments
|
||||||
|
pause
|
||||||
|
exit /b 1
|
||||||
|
)
|
||||||
|
|
||||||
|
echo [OK] Virtual Environment aktiviert
|
||||||
|
|
||||||
|
REM Upgrade pip
|
||||||
|
echo.
|
||||||
|
echo -^> Aktualisiere pip...
|
||||||
|
pip install --upgrade pip --quiet
|
||||||
|
echo [OK] pip aktualisiert
|
||||||
|
|
||||||
|
REM Installiere Abhaengigkeiten
|
||||||
|
echo.
|
||||||
|
echo -^> Installiere Abhaengigkeiten aus requirements.txt...
|
||||||
|
pip install -r requirements.txt
|
||||||
|
|
||||||
|
if %ERRORLEVEL% neq 0 (
|
||||||
|
echo.
|
||||||
|
echo X Fehler beim Installieren der Abhaengigkeiten
|
||||||
|
pause
|
||||||
|
exit /b 1
|
||||||
|
)
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo ========================================
|
||||||
|
echo [OK] Setup erfolgreich abgeschlossen!
|
||||||
|
echo ========================================
|
||||||
|
echo.
|
||||||
|
echo Zum Starten des Programms:
|
||||||
|
echo run.bat
|
||||||
|
echo.
|
||||||
|
echo Oder manuell:
|
||||||
|
echo venv\Scripts\activate.bat
|
||||||
|
echo python main.py
|
||||||
|
echo.
|
||||||
|
pause
|
||||||
|
|
@ -0,0 +1,98 @@
|
||||||
|
#!/bin/bash
|
||||||
|
#
|
||||||
|
# Trimble Geodesy Tool - Setup Script (Linux/macOS)
|
||||||
|
# Erstellt ein Virtual Environment und installiert alle Abhängigkeiten
|
||||||
|
#
|
||||||
|
|
||||||
|
echo "========================================"
|
||||||
|
echo " Trimble Geodesy Tool - Setup"
|
||||||
|
echo "========================================"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
# Wechsle ins Script-Verzeichnis
|
||||||
|
cd "$(dirname "$0")"
|
||||||
|
|
||||||
|
# Prüfe ob Python3 installiert ist
|
||||||
|
if ! command -v python3 &> /dev/null; then
|
||||||
|
echo "❌ Fehler: Python3 ist nicht installiert."
|
||||||
|
echo " Bitte installieren Sie Python3:"
|
||||||
|
echo " Ubuntu/Debian: sudo apt install python3"
|
||||||
|
echo " Fedora: sudo dnf install python3"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo "✓ Python3 gefunden: $(python3 --version)"
|
||||||
|
|
||||||
|
# Prüfe ob python3-venv installiert ist
|
||||||
|
if ! python3 -c "import venv" &> /dev/null; then
|
||||||
|
echo ""
|
||||||
|
echo "❌ Fehler: python3-venv ist nicht installiert."
|
||||||
|
echo ""
|
||||||
|
echo " Bitte installieren Sie python3-venv:"
|
||||||
|
echo " Ubuntu/Debian: sudo apt install python3-venv"
|
||||||
|
echo " Fedora: sudo dnf install python3-venv"
|
||||||
|
echo ""
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo "✓ python3-venv ist verfügbar"
|
||||||
|
|
||||||
|
# Erstelle Virtual Environment
|
||||||
|
echo ""
|
||||||
|
echo "→ Erstelle Virtual Environment..."
|
||||||
|
|
||||||
|
if [ -d "venv" ]; then
|
||||||
|
echo " Virtual Environment existiert bereits."
|
||||||
|
read -p " Neu erstellen? (j/n): " -n 1 -r
|
||||||
|
echo
|
||||||
|
if [[ $REPLY =~ ^[Jj]$ ]]; then
|
||||||
|
rm -rf venv
|
||||||
|
python3 -m venv venv
|
||||||
|
echo " ✓ Virtual Environment neu erstellt"
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
python3 -m venv venv
|
||||||
|
echo " ✓ Virtual Environment erstellt"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Aktiviere Virtual Environment
|
||||||
|
echo ""
|
||||||
|
echo "→ Aktiviere Virtual Environment..."
|
||||||
|
source venv/bin/activate
|
||||||
|
|
||||||
|
if [ $? -ne 0 ]; then
|
||||||
|
echo "❌ Fehler beim Aktivieren des Virtual Environments"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo " ✓ Virtual Environment aktiviert"
|
||||||
|
|
||||||
|
# Upgrade pip
|
||||||
|
echo ""
|
||||||
|
echo "→ Aktualisiere pip..."
|
||||||
|
pip install --upgrade pip --quiet
|
||||||
|
echo " ✓ pip aktualisiert"
|
||||||
|
|
||||||
|
# Installiere Abhängigkeiten
|
||||||
|
echo ""
|
||||||
|
echo "→ Installiere Abhängigkeiten aus requirements.txt..."
|
||||||
|
pip install -r requirements.txt
|
||||||
|
|
||||||
|
if [ $? -ne 0 ]; then
|
||||||
|
echo ""
|
||||||
|
echo "❌ Fehler beim Installieren der Abhängigkeiten"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "========================================"
|
||||||
|
echo " ✓ Setup erfolgreich abgeschlossen!"
|
||||||
|
echo "========================================"
|
||||||
|
echo ""
|
||||||
|
echo "Zum Starten des Programms:"
|
||||||
|
echo " ./run.sh"
|
||||||
|
echo ""
|
||||||
|
echo "Oder manuell:"
|
||||||
|
echo " source venv/bin/activate"
|
||||||
|
echo " python3 main.py"
|
||||||
|
echo ""
|
||||||
Loading…
Reference in New Issue