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 macOS. Werk je op Windows? Bekijk de stappen voor Windows.

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 macOS via code.visualstudio.com/download.
  2. Open het gedownloade zip-bestand en sleep Visual Studio Code naar de map Programma's.
  3. Start VS Code en open het onderdeel Extensions in de balk aan de linkerkant (of druk op Cmd+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 Cmd+V en druk op Enter.

Stap 2

Python installeren

Python is de programmeertaal zelf. Op een Mac installeer je Python met het installatieprogramma van de officiële Python-website.

  1. Ga naar python.org/downloads en klik op Download Python.
  2. Open het gedownloade bestand en doorloop de installatie.
  3. Open een nieuwe terminal en controleer of Python werkt door het versienummer op te vragen. Op een Mac heet de opdracht python3.

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

Terminal: versie controleren
python3 --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 macOS bij Installers op Arm64 als je Mac een Apple-chip heeft (M1, M2 enzovoort), of op x64 bij een Intel-processor. Welke je hebt, zie je via het Apple-menu > Over deze Mac.
  3. Open het gedownloade bestand en doorloop de installatie. Hiervoor heb je je beheerderswachtwoord 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 [/usr/local/share/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. Dubbelklik op het zip-bestand in je map Downloads (Safari doet dit soms al automatisch). Sleep de map DDigit-Python-SDK daarna naar je thuismap. Die open je in de Finder via Ga > Thuismap.
  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
python3 -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 ~/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 python3 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 = os.path.expanduser("~/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.

command not found: python
Op een Mac heet de opdracht python3 in plaats van python. Gebruik je al python3? Sluit dan alle terminals en VS Code en open ze opnieuw, zodat de nieuwe installatie wordt opgepikt.
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 Cmd+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: Can not determine dotnet root
Python kan .NET niet vinden. Meestal is de .NET 10 Runtime nog niet geïnstalleerd: doorloop dan stap 3. Heb je .NET op een andere manier geïnstalleerd, bijvoorbeeld via Homebrew? Installeer het dan alsnog met het installatiebestand uit stap 3, zodat het op de standaardplek staat.
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 🗙