Outdated version of the documentation. Find the latest one here.

Lagen laden

Laten we enkele lagen met gegevens openen. QGIS herkent vector- en rasterlagen. Aanvullend zijn anagepaste typen lagen beschikbaar, maar die zullen we hier niet bespreken.

Vectorlagen

Specificeer de identificatie van de gegevensbron van de laag, de naam voor de laag en de naam van de provider om een vectorlaag te laden:

layer = QgsVectorLayer(data_source, layer_name, provider_name)
if not layer.isValid():
  print "Layer failed to load!"

De identificatie van de gegevensbron van de laag is een string en is specifiek voor elke vector gegevensprovider. De naam van de laag wordt gebruikt in de widget Lagenlijst. Het is belangrijk om te controleren of de laag met succes is geladen. Als dat niet zo was wordt een ongeldige instance van de laag teruggegeven.

De snelste manier om een vectorlaag te openen en weer te geven in QGIS is de functie addVectorLayer van QgisInterface:

layer = iface.addVectorLayer("/path/to/shapefile/file.shp", "layer name you like", "ogr")
if not layer:
  print "Layer failed to load!"

Dit maakt een nieuwe laag en voegt die in één stap toe aan het register van de kaartlagen (waardoor het verschijnt in de lagenlijst). De functie geeft de instance van de laag terug of None als de laag niet kon worden geladen.

De volgende lijst geeft weer hoe toegang wordt verkregen tot verscheidene gegevensbronnen met behulp van vector gegevensproviders:

  • bibliotheek OGR (shapefiles en vele andere bestandsindelingen) — gegevensbron is het pad naar het bestand:

    • vpor shapefile:

      vlayer = QgsVectorLayer("/path/to/shapefile/file.shp", "layer_name_you_like", "ogr")
      
    • voor DXF (let op de interne opties in de URI van de gegevensbron):

      uri = "/path/to/dxffile/file.dxf|layername=entities|geometrytype=Point"
      vlayer = QgsVectorLayer(uri, "layer_name_you_like", "ogr")
      
  • database PostGIS — gegevensbron is een string met alle informatie die nodig is om ene verbinding te maken naar de database van PostgreSQL. De klasse QgsDataSourceURI kan deze string voor u genereren. Onthoud dat QGIS moet worden gecompileerd met ondersteuning voor Postgres, anders is deze provider niet beschikbaar:

    uri = QgsDataSourceURI()
    # set host name, port, database name, username and password
    uri.setConnection("localhost", "5432", "dbname", "johny", "xxx")
    # set database schema, table name, geometry column and optionally
    # subset (WHERE clause)
    uri.setDataSource("public", "roads", "the_geom", "cityid = 2643")
    
    vlayer = QgsVectorLayer(uri.uri(), "layer name you like", "postgres")
    
  • CSV of andere gescheiden tekstbestanden — om een bestand te openen met als scheidingsteken een puntkomma, met een veld “x” voor de X-coördinaat en veld “y” voor de Y-coördinaat zou u iets zoals dit moeten gebruiken:

    uri = "/some/path/file.csv?delimiter=%s&xField=%s&yField=%s" % (";", "x", "y")
    vlayer = QgsVectorLayer(uri, "layer name you like", "delimitedtext")
    

    Opmerking: vanaf QGIS versie 1.7 is de string voor de provider gestructureerd als een URL, dus moet het pad worden voorafgegaan door file://. Ook staat het als WKT (well known text) opgemaakte geometrieën toe als een alternatief voor “X”- en “Y”-velden, en staat toe dat het coördinaten referentiesysteem wordt gespecificeerd. Bijvoorbeeld

    uri = "file:///some/path/file.csv?delimiter=%s&crs=epsg:4723&wktField=%s" % (";", "shape")
    
  • GPX-bestanden — de “GPX”-gegevensprovider leest tracks, routes en waypoints uit GPX-bestanden. Het type (track/route/waypoint) moet worden gespecificeerd als deel van de URL om een bestand te openen:

    uri = "path/to/gpx/file.gpx?type=track"
    vlayer = QgsVectorLayer(uri, "layer name you like", "gpx")
    
  • database SpatiaLite — ondersteund vanaf QGIS v1.1. Soortgelijk aan databases van PostGIS, QgsDataSourceURI kan worden gebruikt voor het genereren van de identificatie van de gegevensbron:

    uri = QgsDataSourceURI()
    uri.setDatabase('/home/martin/test-2.3.sqlite')
    schema = ''
    table = 'Towns'
    geom_column = 'Geometry'
    uri.setDataSource(schema, table, geom_column)
    
    display_name = 'Towns'
    vlayer = QgsVectorLayer(uri.uri(), display_name, 'spatialite')
    
  • MySQL op WKB gebaseerde geometrieën, via OGR — gegevensbron is de string voor de verbinding naar de tabel:

    uri = "MySQL:dbname,host=localhost,port=3306,user=root,password=xxx|layername=my_table"
    vlayer = QgsVectorLayer( uri, "my table", "ogr" )
    
  • WFS-verbinding:. de verbinding wordt gedefinieerd met een URI en het gebruiken van de provider WFS:

    uri = "http://localhost:8080/geoserver/wfs?srsname=EPSG:23030&typename=union&version=1.0.0&request=GetFeature&service=WFS",
    vlayer = QgsVectorLayer(uri, "my wfs layer", "WFS")
    

    De URI kan worden gemaakt met behulp van de standaard bibliotheek urllib:

    params = {
        'service': 'WFS',
        'version': '1.0.0',
        'request': 'GetFeature',
        'typename': 'union',
        'srsname': "EPSG:23030"
    }
    uri = 'http://localhost:8080/geoserver/wfs?' + urllib.unquote(urllib.urlencode(params))
    

Notitie

U kunt de gegevensbron van een bestaande laag wijzigen door setDataSource() op een instantie van QgsVectorLayer aan te roepen, zoals in het volgende voorbeeld:

# layer is a vector layer, uri is a QgsDataSourceURI instance
layer.setDataSource(uri.uri(), "layer name you like", "postgres")

Rasterlagen

Voor toegang tot rasterbestanden wordt de bibliotheek GDAL gebruikt. Het ondersteunt een breed scala aan bestandsindelingen. In het geval u problemen hebt met et openen van enkele bestanden, controleer dan of uw GDAL ondersteuning heeft voor die bepaalde indeling (niet alle indelingen zijn standaard beschikbaar). Specificeer zijn bestandsnaam en basisnaam om een raster uit een bestand te laden:

fileName = "/path/to/raster/file.tif"
fileInfo = QFileInfo(fileName)
baseName = fileInfo.baseName()
rlayer = QgsRasterLayer(fileName, baseName)
if not rlayer.isValid():
  print "Layer failed to load!"

Soortgelijk aan vectorlagen kunnen rasterlagen worden geladen met behulp van de functie addRasterLayer van QgisInterface:

iface.addRasterLayer("/path/to/raster/file.tif", "layer name you like")

Dit maakt een nieuwe laag en voegt die in één stap toe aan het register van de kaartlagen (waardoor het verschijnt in de lagenlijst).

Rasterlagen kunnen ook worden gemaakt vanuit een service voor WCS:

layer_name = 'modis'
uri = QgsDataSourceURI()
uri.setParam('url', 'http://demo.mapserver.org/cgi-bin/wcs')
uri.setParam("identifier", layer_name)
rlayer = QgsRasterLayer(str(uri.encodedUri()), 'my wcs layer', 'wcs')

gedetailleerde instellingen voor de URI kunnen worden gevonden in provider documentation

Als alternatief kunt u een rasterlaag laden vanaf een server voor WMS. Momenteel is het echter niet mogelijk om toegang te krijgen tot het antwoord van GetCapabilities van de API — u moet weten welke lagen u wilt:

urlWithParams = 'url=http://wms.jpl.nasa.gov/wms.cgi&layers=global_mosaic&styles=pseudo&format=image/jpeg&crs=EPSG:4326'
rlayer = QgsRasterLayer(urlWithParams, 'some layer name', 'wms')
if not rlayer.isValid():
  print "Layer failed to load!"

Register van kaartlagen

Als u de geopende lagen wilt gebruiken voor renderen, vergeet dan niet om ze toe te voegen aan het register van kaartlagen. Het register van kaartlagen wordt eigenaar van de lagen en er kan later toegang toe worden verkregen vanuit elk deel van de toepassing door middel van hun unieke ID. Als de laag wordt verwijderd uit het register van de kaartlagen, wordt hij ook verwijderd.

Een kaartlaag aan het register toevoegen:

QgsMapLayerRegistry.instance().addMapLayer(layer)

Lagen worden bij het afsluiten automatisch vernietigd, als u echter de laag expliciet wilt verwijderen, gebruik dan:

QgsMapLayerRegistry.instance().removeMapLayer(layer_id)

Voor een lijst van geladen lagen en laag-ID’s, gebruik:

QgsMapLayerRegistry.instance().mapLayers()