Convertir le raster en entité (Analyse raster)

Synthèse

Convertit un raster en jeu de classes d’entités, tel que des points, lignes ou polygones.

Illustration

Outil Convertir le raster en entité

Utilisation

  • Cet outil de portail d’analyse raster est disponible lorsque vous êtes connecté à un portail ArcGIS Enterprise disposant d’un ArcGIS Image Server configuré pour Analyse raster. Lorsque cet outil est appelé, ArcGIS Pro est utilisé comme client et le traitement est effectué dans les serveurs fédérés avec ArcGIS Enterprise. Cet outil du portail prend en charge les couches de votre portail en entrée et crée la sortie dans le portail.

    La couche raster en entrée prend en charge les éléments suivants : couche du portail, URI ou URL d’un service d’imagerie ou sortie de l’outil Créer une couche de serveur d’imagerie. Cet outil ne prend pas en charge les données raster ou les couches locales.

  • Les rasters peuvent être convertis en entités ponctuelles, linéaires ou surfaciques.

Paramètres

ÉtiquetteExplicationType de données
Couche raster en entrée

Couche raster en entrée.

Feature Set
Champ

Champ spécifiant la valeur de conversion.

Il peut s'agir d'un entier ou d'une valeur textuelle.

Un champ contenant des valeurs à virgule flottante peut uniquement servir si la sortie est destinée à être un jeu de données ponctuelles.

Le champ par défaut est Value, qui contient la valeur de chaque cellule raster.

Field
Type en sortie

Spécifie le type en sortie.

Si le type en sortie est Line (Ligne) ou Polygon (Polygone), un paramètre supplémentaire apparaît pour pouvoir simplifier les lignes ou les polygones.

  • PointLe raster sera converti en un jeu de données ponctuelles. Il s’agit de l’option par défaut.
  • LigneLe raster sera converti en un jeu de données d'entités linéaires.
  • SurfaceLe raster sera converti en jeu de données d'entités surfaciques.
String
Simplifier des lignes ou des polygones
(Facultatif)

Indique si les lignes ou les polygones sont simplifiés (lissés). Le lissage est effectué de manière que la ligne contienne un nombre minimal de segments tout en restant le plus proche possible des bords des cellules raster d'origine.

  • Cochée : les entités linéaires ou surfaciques sont lissées pour produire un résultat plus généralisé. Il s’agit de l’option par défaut.
  • Non cochée : les entités linéaires ou surfaciques ne sont pas lissées et suivent les limites des cellules du jeu de données raster.
Boolean
Nom en sortie

Classe d’entité en sortie destinée à contenir les points, lignes ou polygones convertis.

String
Créer des entités multi-parties
(Facultatif)

Indique si les polygones en sortie se composent d’entités en une seule partie ou multi-parties.

  • Cochée : les entités multi-parties sont créées sur la base de polygones de même valeur.
  • Non cochée : des entités individuelles (à une partie) sont créées pour chaque polygone. Il s’agit de l’option par défaut.
Boolean
Maximum Vertices Per Polygon Feature (Nombre maximal de sommets par entité surfacique)
(Facultatif)

La limite de sommet utilisée pour sous-diviser un polygone en polygones plus petits. Ce paramètre génère une sortie analogue à celle créée par l’outil Segmenter de la boîte d’outils Data Management (Gestion des données).

Si laissée vide, les polygones de sortie ne seront pas séparés. Il s’agit de l’option par défaut.

Ce paramètre n’est pris en charge que si Output Type (Type en sortie) est Polygon (Polygone).

Long

Sortie obtenue

ÉtiquetteExplicationType de données
Entité en sortie

Les entités en sortie.

Classe d’entités

arcpy.ra.ConvertRasterToFeature(inputRaster, field, outputType, {simplifyLinesOrPolygons}, outputName, {createMultipartFeatures}, {maxVerticesPerFeature})
NomExplicationType de données
inputRaster

Couche raster en entrée.

Feature Set
field

Champ spécifiant la valeur de conversion.

Il peut s'agir d'un entier ou d'une valeur textuelle.

Un champ contenant des valeurs à virgule flottante peut uniquement servir si la sortie est destinée à être un jeu de données ponctuelles.

Le champ par défaut est Value, qui contient la valeur de chaque cellule raster.

Field
outputType

Spécifie le type en sortie.

  • POINTLe raster sera converti en un jeu de données ponctuelles. Il s’agit de l’option par défaut.
  • LINELe raster sera converti en un jeu de données d'entités linéaires.
  • POLYGONLe raster sera converti en jeu de données d'entités surfaciques.
String
simplifyLinesOrPolygons
(Facultatif)

Indique si les lignes ou les polygones sont simplifiés (lissés). Le lissage est effectué de manière que la ligne contienne un nombre minimal de segments tout en restant le plus proche possible des bords des cellules raster d'origine.

  • SIMPLIFYLes entités linéaires ou surfaciques sont lissées pour produire un résultat plus généralisé. Il s’agit de l’option par défaut.
  • NO_SIMPLIFYLes entités linéaires ou surfaciques ne sont pas lissées et suivent les limites des cellules du jeu de données raster.

Ce paramètre n’est pris en charge que si outputType est LINE ou POLYGON.

Boolean
outputName

Classe d’entité en sortie destinée à contenir les points, lignes ou polygones convertis.

String
createMultipartFeatures
(Facultatif)

Indique si les polygones en sortie se composent d’entités en une seule partie ou multi-parties.

  • MULTIPLE_OUTER_PARTLes entités multi-parties sont créées sur la base de polygones de même valeur.
  • SINGLE_OUTER_PARTDes entités individuelles (à une partie) sont créées pour chaque polygone. Il s’agit de l’option par défaut.

Ce paramètre n’est pris en charge que si outputType est POLYGON.

Boolean
maxVerticesPerFeature
(Facultatif)

La limite de sommet utilisée pour sous-diviser un polygone en polygones plus petits. Ce paramètre génère une sortie analogue à celle créée par l’outil Segmenter de la boîte d’outils Data Management (Gestion des données).

Si laissée vide, les polygones de sortie ne seront pas séparés. Il s’agit de l’option par défaut.

Ce paramètre n’est pris en charge que si outputType est POLYGON.

Long

Sortie obtenue

NomExplicationType de données
outputFeatures

Les entités en sortie.

Classe d’entités

Exemple de code

Exemple 1 d'utilisation de l'outil ConvertRasterToFeature (fenêtre Python)

Cet exemple convertit un raster en entités surfaciques.

import arcpy
arcpy.ra.ConvertRasterToFeature('https://MyPortal.esri.com/server/rest/services/Hosted/Landuse/ImageServer', 
                                'Value', 'POLYGON', 'SIMPLIFY', 'outFeatures')
Exemple 2 d'utilisation de l'outil ConvertRasterToFeature (script autonome)

Cet exemple convertit un raster en entités surfaciques.

#-------------------------------------------------------------------------------
# Name: ConvertRasterToFeature_Ex_02.py
# Description: Convert a raster to polygon features.
#
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inRaster = 'https://MyPortal.esri.com/server/rest/services/Hosted/Landuse/ImageServer'
inField = 'Value'
outType = 'POLYGON'
simplify = 'SIMPLIFY'
outFeatures = 'outFeatures'
arcpy.ra.ConvertRasterToFeature(inRaster, inField, outType, simplify, outFeatures)

Informations de licence

  • Basic: Nécessite ArcGIS Image Server
  • Standard: Nécessite ArcGIS Image Server
  • Advanced: Nécessite ArcGIS Image Server

Rubriques connexes