English

English

Python installeren

Je computer klaarmaken om met Python en je collectiedata te werken

Op deze pagina zet je stap voor stap alles klaar om vanuit Python met de software van Double Dig IT te werken. Je installeert een editor, Python zelf, het .NET-platform waar onze software op draait en de Double Dig IT Python SDK. Tot slot controleer je met een kort testscript of alles werkt.

Reken op ongeveer een half uur. Werk je op een laptop van je organisatie? Voor stap 3 zijn beheerdersrechten nodig, dus schakel eventueel je ICT-afdeling in.

Deze handleiding is voor Windows. Werk je op een Mac? Bekijk de stappen voor macOS.

Python
Stap 1

Visual Studio Code installeren

Visual Studio Code (VS Code) is een gratis editor van Microsoft waarin je Python-scripts schrijft, uitvoert en debugt. Het is lichtgewicht en werkt goed samen met Python en .NET.

  1. Download VS Code voor Windows via code.visualstudio.com/download.
  2. Open het gedownloade bestand en doorloop de installatie. De standaardinstellingen zijn prima.
  3. Start VS Code en open het onderdeel Extensions in de balk aan de linkerkant (of druk op Ctrl+Shift+X).
  4. Zoek op Python en installeer de Python-extensie van Microsoft.

Een terminal openen

In de volgende stappen typ je een paar opdrachten in een terminal. Dat kan direct in VS Code via het menu Terminal > New Terminal. Onderin het venster verschijnt dan een regel waar je opdrachten kunt typen.

Bij elk codeblok op deze pagina staat een knop om de tekst te kopiëren. Plak de opdracht in de terminal met Ctrl+V en druk op Enter.

Stap 2

Python installeren

Python is de programmeertaal zelf. Op Windows installeer je Python tegenwoordig met de Python install manager van de officiële Python-website.

  1. Ga naar python.org/downloads en klik op Download Python install manager.
  2. Open het gedownloade bestand en klik op Install.
  3. Open een nieuwe terminal en installeer de nieuwste versie van Python met de opdracht bij deze stap. Vraagt het programma of het een map aan je PATH mag toevoegen? Antwoord dan met y (ja).
  4. Controleer daarna of Python werkt door het versienummer op te vragen.

Staat Python al op je computer? Controleer dan alleen het versienummer. Versie 3.11 of nieuwer is goed.

Terminal: Python installeren
py install default
Terminal: versie controleren
python --version
Verwachte uitkomst
Python 3.15.0

Een hoger versienummer is natuurlijk ook goed.

Stap 3

.NET 10 Runtime installeren

De software van Double Dig IT is gebouwd op .NET, het softwareplatform van Microsoft. Om die software vanuit Python te kunnen gebruiken, heeft je computer de .NET 10 Runtime nodig.

  1. Ga naar de downloadpagina van .NET 10.
  2. Scrol naar het blok .NET Runtime 10.0 en klik in de regel Windows bij Installers op x64. Heeft je computer een Arm-processor, kies dan Arm64.
  3. Open het gedownloade bestand en klik op Install. Hiervoor zijn beheerdersrechten nodig.
  4. Open een nieuwe terminal en controleer de installatie met de opdracht bij deze stap.

Staat de .NET 10 SDK al op je computer? Daar zit de runtime al in, dus dan kun je deze stap overslaan.

Terminal: .NET controleren
dotnet --list-runtimes

In de lijst moet een regel staan die begint met Microsoft.NETCore.App 10.0, bijvoorbeeld:

Verwachte uitkomst
Microsoft.NETCore.App 10.0.13 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
Stap 4

De Double Dig IT Python SDK installeren

De Python SDK bevat de software waarmee Python rechtstreeks met je collectiedata kan werken. Python communiceert met deze .NET-software via het pakket pythonnet, dat je in deze stap ook installeert.

  1. Download de Python SDK met de knop hieronder.
  2. Klik met de rechtermuisknop op het zip-bestand, kies Alles uitpakken en vul als doel C:\ in. Je krijgt dan de map C:\DDigit-Python-SDK, met daarin de map dotnet.
  3. Installeer pythonnet met de opdracht bij deze stap.
Download de Python SDK

Liever een andere plek? Dat kan. Onthoud dan waar je de SDK hebt uitgepakt, want in stap 5 heb je dat pad nodig.

Terminal: pythonnet installeren
python -m pip install pythonnet

De installatie eindigt met een regel die begint met Successfully installed. Zie je Requirement already satisfied? Dan stond pythonnet er al op, en dat is ook goed.

Stap 5

Testen of alles werkt

Nu komt alles samen. Je maakt een werkmap met twee kleine Python-bestanden en voert een test uit.

  1. Maak een map voor je scripts, bijvoorbeeld C:\Python-Collectiedata, en open die in VS Code via File > Open Folder.
  2. Maak in die map het bestand ddigit_bootstrap.py aan (File > New File) en plak de bijbehorende code erin. Dit bestand laadt de Double Dig IT software. Je eigen scripts hoeven het daarna alleen nog te importeren. Heb je de SDK ergens anders neergezet? Pas dan het pad bij sdkPath aan.
  3. Maak op dezelfde manier het bestand test_installatie.py aan met de bijbehorende code.
  4. Voer het testscript uit met het afspeelknopje rechtsboven in VS Code (Run Python File), of typ in de terminal python test_installatie.py.

Zie je de tekst "Gelukt!" in de terminal verschijnen? Dan is je computer klaar om met Python en collectiedata te werken.

ddigit_bootstrap.py
import osimport sys# pas dit pad aan als je de SDK ergens anders hebt neergezetsdkPath = r"C:\DDigit-Python-SDK\dotnet"# voeg de SDK-map toe aan de zoekpaden van Pythonsys.path.insert(0, sdkPath)# laad de .NET runtime met de configuratie uit de SDKfrom pythonnet import loadload("coreclr", runtime_config=os.path.join(sdkPath, "DDigit.PythonHost.runtimeconfig.json"))# laad de Double Dig IT DataProviderimport clrclr.AddReference(os.path.join(sdkPath, "DDigit.DataProvider.dll"))
test_installatie.py
import sysimport ddigit_bootstrapfrom DDigit.DataProvider import DDataProviderdataProvider = DDataProvider()print("Python", sys.version.split()[0])print("Gelukt! De Double Dig IT Python SDK werkt.")
Verwachte uitkomst
Python 3.15.0
Gelukt! De Double Dig IT Python SDK werkt.

Werkt het niet?

Geen zorgen, de meeste problemen zijn snel opgelost. Zoek de foutmelding die je ziet op in de lijst hieronder.

python wordt niet herkend, of de Microsoft Store opent
Sluit alle terminals en VS Code en open ze opnieuw, zodat de nieuwe installatie wordt opgepikt. Werkt het nog steeds niet? Zoek in het startmenu naar Aliassen voor app-uitvoering (Engels: App execution aliases) en controleer of Python (default) aan staat.
ModuleNotFoundError: No module named 'pythonnet'
Pythonnet is nog niet geïnstalleerd voor de Python-versie die VS Code gebruikt. Voer de opdracht uit stap 4 nogmaals uit. Kies daarna in VS Code via Ctrl+Shift+P > Python: Select Interpreter dezelfde Python-versie als in de terminal.
ModuleNotFoundError: No module named 'ddigit_bootstrap'
Python kan het bestand ddigit_bootstrap.py niet vinden. Zorg dat het in dezelfde map staat als test_installatie.py en dat de bestandsnaam precies klopt.
RuntimeError: Failed to create a .NET runtime (coreclr)
Python kan .NET of de SDK niet vinden. Controleer of in de map uit ddigit_bootstrap.py het bestand DDigit.DataProvider.dll staat. Let op dat je bij het uitpakken niet per ongeluk een extra map hebt gemaakt, zoals DDigit-Python-SDK\DDigit-Python-SDK. Klopt het pad? Controleer dan stap 3 en start daarna VS Code opnieuw.

Kom je er niet uit? Neem contact met ons op en stuur de volledige foutmelding mee, dan helpen we je verder.

Alles klaar? Dan kun je aan de slag!

Je kunt nu vanuit Python rechtstreeks met je collectiedata werken. Heb je vragen, of wil je hulp bij je eerste scripts? Neem gerust contact met ons op.

Neem contact op

Bronnen

Python leren

Wil je meer weten over Python zelf? De officiële Python-tutorial is een goed startpunt.

An unhandled error has occurred. Reload 🗙