pkextract - En ligne dans le Cloud

PROGRAMME:

Nom

pkextract - extrait les valeurs de pixels d'une image raster à partir d'un échantillon (vecteur ou raster)

SYNOPSIS

pkextrait -i contribution [-s échantillon | -rand nombre | -la grille Taille] -o sortie [Options] [Avancée
Options]

DESCRIPTION

pkextrait extrait les valeurs de pixel d'un jeu de données raster en entrée, en fonction des emplacements que vous
fournir via un fichier exemple. Alternativement, un échantillon aléatoire ou une grille systématique de points
peut également être extrait. L'échantillon peut être un fichier vectoriel avec des points ou des polygones. Dans le
cas des polygones, vous pouvez soit extraire les valeurs de tous les pixels raster qui sont couverts
par les polygones, ou extraire une valeur unique pour chaque polygone telle que le centroïde, la moyenne,
médiane, etc. En sortie, une nouvelle copie du fichier vectoriel est créée avec un attribut supplémentaire
pour la valeur de pixel extraite. Pour chaque bande raster dans l'image d'entrée, un
l'attribut est créé. Par exemple, si le jeu de données raster contient trois canaux, trois
des attributs sont créés (b0, b1 et b2).

Au lieu d'un jeu de données vectorielles, l'échantillon peut également être un jeu de données raster avec
valeurs. Le cas d'utilisation typique est une carte d'occupation du sol qui chevauche le jeu de données raster en entrée.
L'utilitaire extrait ensuite les pixels du raster d'entrée pour la couverture terrestre respective
Des classes. Pour sélectionner un sous-ensemble aléatoire de l'exemple de jeu de données raster, vous pouvez définir le seuil
option -t avec une valeur en pourcentage.

Une utilisation typique de pkextrait est de préparer un échantillon d'apprentissage pour l'un des classificateurs
implémenté dans pktools.

Présentation des règles d'extraction possibles :

Règle d'extraction Fonctionnalités de sortie
point Extraire toutes les valeurs de pixels couvertes
par le polygone (option -polygone
non défini) ou extraire un pixel sur
l'option surface (-polygone
set).
centroid Extraire la valeur du pixel au
centre de gravité du polygone.
moyenne Extraire la moyenne de tous les pixels
valeurs dans le polygone.
stdev Extraire l'écart type de
toutes les valeurs de pixel dans le
polygone.
median Extraire la médiane de tous les pixels
valeurs dans le polygone.
min Extraire la valeur minimale de tous
pixels dans le polygone.
max Extraire la valeur maximale de tous
pixels dans le polygone.
sum Extraire la somme des valeurs de tous
pixels dans le polygone.
mode Extraire le mode des classes
dans le polygone (les classes doivent
être réglé avec la classe d'option).
proportion Extraire la proportion de classe(s)
dans le polygone (les classes doivent
être réglé avec la classe d'option).
count Extraire le nombre de classe(s)
dans le polygone (les classes doivent
être réglé avec la classe d'option).

centile Extraire le centile tel que défini par
option perc (par exemple, 95e
centile des valeurs couvertes par
polygone).

OPTIONS

-i nom de fichier, --saisir nom de fichier
Jeu de données raster en entrée contenant des informations sur la bande

-s échantillon, --échantillon échantillon
Jeu de données vectorielles OGR avec des caractéristiques à extraire des données d'entrée. La sortie sera
contiennent des fonctionnalités avec des informations de bande d'entrée incluses. L'exemple d'image peut également être
Jeu de données raster GDAL.

-rand nombre, --Aléatoire nombre
Créez un échantillon aléatoire simple de points. Fournir le nombre de points à générer

-la grille Taille, --la grille Taille
Créer une grille systématique de points. Fournissez la taille de la grille de cellules (en unités projetées,
par exemple,. m)

-o nom de fichier, --output nom de fichier
Exemple de jeu de données en sortie Exemple de jeu de données en sortie

-ln couche, --ln couche
Nom(s) de couche dans l'échantillon (laisser vide pour tout sélectionner)

-c classe, --classer classe
Classe(s) à extraire de l'image échantillon d'entrée. Laisser vide pour extraire tous les valides
pixels de données de l'exemple de jeu de données. Assurez-vous de définir des classes si la règle est définie sur mode,
proportion ou compte.

-t порог, --seuil порог
Seuil de probabilité de sélection des échantillons (au hasard). Fournir la probabilité dans
pourcentage (>0) ou absolu (<0). Utiliser un seuil unique pour l'échantillon vectoriel
ensembles de données. Si vous utilisez des cartes raster d'occupation du sol comme exemple de jeu de données, vous pouvez fournir un
valeur seuil pour chaque classe (par ex. -t 80 -t 60). Utilisez la valeur 100 pour tout sélectionner
pixels pour la ou les classes sélectionnées

-f le format, --F le format
Exemple de format d'ensemble de données de sortie

-pi type de champ, --ftype type de champ
Type de champ (uniquement Real ou Integer)

-lt type d'étiquette, --type type d'étiquette
Type d'étiquette : In16 ou String

-polygone, --polygone
Créez OGRPolygon en tant que géométrie au lieu de OGRPoint.

-b bande, --bande bande
Index de bande à extraire. Laisser vide pour utiliser toutes les bandes

-bande bande, --bande de démarrage bande
Numéro de séquence de la bande de début

-ebande bande, --bande d'extrémité bande
Numéro de séquence de fin de bande

-r exclure, --régner exclure
Règle comment rapporter les informations d'image par caractéristique (uniquement pour l'échantillon vectoriel). point
(valeur à chaque point ou au centroïde si polygone), centroïde, moyenne, stdev, médiane,
proportion, nombre, min, max, mode, somme, centile.

-v niveau, --verbeux niveau
Mode verbeux si > 0

Options avancées

-bndnodata bande, --bndnodata bande
Bande(s) dans l'image d'entrée pour vérifier si le pixel est valide (utilisé pour srcnodata)

-srcnodata Plus-value, --srcnodata Plus-value
Valeur(s) non valide(s) pour l'image d'entrée

-tp порог, --thresholdPolygone порог
seuil (absolu) pour sélectionner des échantillons dans chaque polygone

-tester échantillon de test, --test échantillon de test
Testez l'échantillon de données (utilisez cette option en combinaison avec le seuil <100 pour créer un
formation (sortie) et ensemble de test

-md attribuer, --bnom attribuer
Pour les données d'entrée à bande unique, ce nom d'attribut supplémentaire correspondra au raster
valeurs. Pour les données d'entrée multibandes, plusieurs attributs avec ce préfixe seront
ajouté (par exemple b0, b1, b2, etc.)

-cn attribuer, --cname attribuer
Nom de l'étiquette de classe dans l'ensemble de données vectorielles en sortie

-géo Plus-value, --géo Plus-value
Utiliser les coordonnées géographiques (définir sur 0 pour utiliser les coordonnées de l'image)

-vers le bas Plus-value, --vers le bas Plus-value
Facteur de sous-échantillonnage (pour les jeux de données d'échantillons raster uniquement). Peut être utilisé pour créer une grille
des notes bonus

-buff Plus-value, --amortir Plus-value
Buffer pour le calcul des statistiques des entités ponctuelles

-circ, --circulaire
Utilisez un tampon de noyau de disque circulaire (pour les ensembles de données d'échantillons de points vectoriels uniquement, utilisez dans
combinaison avec option tampon)

EXEMPLE

En utilisant vecteur échantillons

Extraire tous les points de toutes les couches lues points.sqlite de entrée.tif. Créer un nouveau
jeu de données vectorielles ponctuel nommé extrait.sqlite, où chaque point contiendra un attribut
pour les bandes d'entrée individuelles dans entrée.tif. Notez que le format vectoriel par défaut est
Spatialité (.sqlite).

pkextrait -i entrée.tif -s points.sqlite -o extrait.sqlite

Même exemple que ci-dessus, mais extraire uniquement les points de la couche dans points.sqlite nommé
"valide"

pkextrait -i entrée.tif -s points.sqlite -ln Info de contact. -o extrait.sqlite

Extraire des points et écrire la sortie au format ESRI Shapefile

pkextrait -i entrée.tif -s points.shp -f "ESRI Fichier de formes" -o extrait.sqlite

Extraire l'écart type pour chaque bande d'entrée dans une fenêtre 3 par 3, centrée autour de la
points dans l'exemple de jeu de données vectorielles points.sqlite. Le jeu de données vectorielles en sortie contiendra
entités surfaciques définies par les points tamponnés (fenêtre 3x3). Utilisez l'option -circ à
définir un tampon circulaire.

pkextrait -i entrée.tif -s points.sqlite -o extrait.sqlite -r développement standard -buff 3 -polygone

Extraire tous les pixels de entrée.tif couvert par les polygones de emplacements.sqlite. Chaque
polygone peut ainsi donner lieu à plusieurs entités ponctuelles avec des attributs pour chaque bande en entrée.
Écrire les points extraits dans un jeu de données vectorielles de points formation.sqlite.

pkextrait -i entrée.tif -s polygones.sqlite -o formation.sqlite -r point

Extraire la première bande de entrée.tif aux centroïdes des polygones dans le jeu de données vectorielles
polygones.sqlite. Attribuez la valeur du point extrait à un nouvel attribut du polygone et
écrire dans le jeu de données vectorielles extrait.sqlite.

pkextrait -i entrée.tif -b 0 -s polygones.sqlite -r centroïde -o extrait.sqlite -polygone

Extraire les valeurs moyennes de la deuxième bande dans entrée.tif couvert par chaque polygone dans
polygones.sqlite. Les valeurs moyennes sont écrites sur une copie des polygones dans le vecteur de sortie
jeu de données extrait.sqlite

pkextrait -i entrée.tif -b 1 -s polygones.sqlite -r signifier -o extrait.sqlite -polygone

Extrayez la classe majoritaire dans chaque polygone pour la carte d'occupation du sol en entrée. L'occupation du sol
map contient cinq classes valides, étiquetées 1-5. D'autres valeurs de classe (par exemple, étiquetées comme 0) sont
pas pris en compte dans le vote.

pkextrait -i landcover.tif -s polygones.sqlite -r vote max -o majorité.sqlite -polygone -c 1 -c 2 -c 3 -c 4 -c 5

En utilisant aléatoire et mes grille échantillons

Extraire 100 unités d'échantillonnage en suivant un plan d'échantillonnage aléatoire simple. Pour chaque unité d'échantillonnage,
la valeur médiane est extraite du jeu de données raster en entrée dans une fenêtre de 3 x 3 pixels
et écrit dans un attribut de l'ensemble de données vectorielles de sortie. Le jeu de données vectorielles en sortie
contient des entités surfaciques définies par les fenêtres centrées sur l'échantillon sélectionné au hasard
unités.

pkextrait -i entrée.tif -o aléatoire.sqlite -rand 100 -médian -buff 3 -polygone

Extraire les points suivant une grille systématique avec une taille de maille de 100 m. Supprimer les pixels
qui ont une valeur 0 dans le jeu de données raster en entrée.

pkextrait -i entrée.tif -o systématique.sqlite -la grille 100 -srcnodata 0

En utilisant raster échantillons

Utilisation typique où les pixels sont extraits sur la base d'une carte d'occupation du sol (exemple.tif). Extrait
toutes les bandes pour un échantillon aléatoire de 10 pour cent des pixels de la carte d'occupation du sol exemple.tif
où les classes d'occupation du sol sont soit 1,2, 3 ou XNUMX (valeurs de classe). Écrire la sortie dans le
jeu de données vectorielles ponctuelles extrait.sqlite.

pkextrait -i entrée.tif -s exemple.tif -o extrait.sqlite -t 10 -c 1 -c 2 -c 3

Extraire toutes les bandes pour les 5000 premiers pixels rencontrés dans exemple.tif où les pixels ont un
valeur égale à 1. Écrire la sortie dans l'ensemble de données vectorielles du point extrait.sqlite.

pkextrait -i entrée.tif -s exemple.tif -o extrait.sqlite -t - 5000 -c 1

24 Janvier 2016 pkextrait(1)

Utilisez pkextract en ligne à l'aide des services onworks.net