Allocation de distance (Outils d'analyse raster)

Résumé

Calcule l’allocation de distance de chaque cellule vers les sources fournies en fonction des facteurs de distance en ligne droite, distance de coût et distance de surface véritable, ainsi que des facteurs horizontaux et verticaux de coût.

Illustration

Processus Distance Allocation (Allocation de distance)

Utilisation

Cet outil de portail de l’analyse raster est disponible lorsque vous êtes connecté à un portail ArcGIS Enterprise où un ArcGIS Image Server est configuré pour l’analyse raster. Lorsqu’un outil est exécuté, ArcGIS Pro est utilisé comme client et le traitement est effectué sur les serveurs fédérés avec ArcGIS Enterprise. L'outil de portail accepte les couches de votre portail en entrée et crée la sortie dans votre 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 Make Image Server Layer (Créer une couche de serveur d’imagerie). La couche d'entités en entrée peut correspondre à une couche du portail, un URI ou une URL vers un service d'entités. Cet outil ne prend pas en charge les couches ou données raster locales. Vous pouvez utiliser des couches et données d'entités locales en entrée dans cet outil de portail, mais il est recommandé d’utiliser les couches de votre portail en entrée.
Les données source en entrée peuvent correspondre à un service d'entités ou d’imagerie. Le service d’entités peut être de type ponctuel, linéaire ou surfacique.
Si une source renvoie NoData dans l'un des rasters en entrée correspondant, elle est ignorée dans l'analyse et, par conséquent, aucune distance de cette source n'est calculée.
Lorsque les données source en entrée correspondent à un service d’imagerie, l’ensemble des cellules source englobe toutes les cellules du raster source comprenant des valeurs valides. Les cellules associées à la valeur NoData ne figurent pas dans la source. La valeur 0 est considérée comme une source normale.
Lorsque les données source en entrée correspondent à un service d’entités, les emplacements source sont convertis en interne en raster avant l’analyse. Vous pouvez contrôler la résolution du raster à l’aide du paramètre d’environnement Cell Size (Taille de cellule). Par défaut, si aucun autre raster n’est spécifié dans l’outil, la résolution est déterminée par la valeur la plus grande entre la largeur et la hauteur de l’étendue de l’entité en entrée, dans la référence spatiale en entrée, divisée par 1 000.
Pour éviter cette situation, vous pouvez entre-temps effectuer la rasterisation des entités en entrée directement avec l’outil Feature to Raster (Entité vers raster) et définir le paramètre Field (Champ). Ensuite, utilisez la sortie en entrée dans l'outil de distance que vous souhaitez utiliser. Vous pouvez également sélectionner une petite taille de cellule pour capturer le nombre de détails approprié à partir des entités en entrée.
Les interruptions sont des obstacles qui doivent être contournés. Elles peuvent être définies de deux façons.

Pour le paramètre Input Raster or Feature Barriers (Raster ou entités d’interruption en entrée), les interruptions peuvent être représentées par des cellules qui contiennent une valeur valide ou par des données d’entités qui sont converties en raster. À l’endroit où les interruptions sont connectées uniquement par des cellules en diagonale, elles sont épaissies pour devenir imperméables.

Les interruptions sont également définies par des localisations où aucune cellule NoData n’existe dans les entrées suivantes : Input Cost Raster (Raster de coût en entrée), Input Surface Raster (Raster de surface en entrée), Input Vertical Raster (Raster vertical en entrée) et Input Horizontal Raster (Raster horizontal en entrée). À l’endroit où les cellules NoData sont connectées uniquement par des cellules en diagonale, elles sont épaissies à l’aide de cellules NoData supplémentaires pour devenir une interruption imperméable.
Si la valeur Input Surface Raster (Raster de surface en entrée) comporte un système de coordonnées verticales (VCS), les valeurs du raster de surface sont considérées comme étant exprimées dans les unités du VCS. Si la valeur Input Surface Raster (Raster de surface en entrée) n’a aucun système de coordonnées verticales et que les données sont projetées, les valeurs de surface sont considérées comme étant exprimées en unités linéaires de la référence spatiale. Si la valeur Input Surface Raster (Raster de surface en entrée) ne possède pas de système de coordonnées verticales et que les données ne sont pas projetées, les valeurs de surface sont considérées comme étant exprimées en mètres. Le résultat de l’accumulation de distance finale est exprimé en coût par unité linéaire, ou en unités linéaires si aucun coût n’est présent.
Les valeurs de raster de coût négatives ou nulles ne sont pas valides, mais sont traitées comme petites valeurs positives. L’algorithme de coût cumulé est un processus multiplicatif ; il ne peut pas calculer correctement le coût cumulé si les valeurs de coût sont négatives ou nulles. Si le raster de coût contient ces valeurs et que ces emplacements représentent des zones à exclure de l’analyse, convertissez ces cellules en NoData avant d’exécuter l’outil. Pour cela, utilisez l’outil Set Null de l’extension ArcGIS Spatial Analyst. La valeur NoData étant traitée comme une interruption dans cette analyse, les emplacements qui sont NoData dans l’entrée le sont également dans le résultat.
Les valeurs par défaut des modificateurs de facteur vertical sont les suivantes :

<!--```nohighlight Keyword Zero Low High Slope Power Cos Sec factor cut cut power power angle angle

Binary 1.0 -30 30 ~ ~ ~ ~ Linear 1.0 -90 90 1/90 ~ ~ ~ Symmetric linear 1.0 -90 90 1/90 ~ ~ ~ Inverse linear 1.0 -45 45 -1/45 ~ ~ ~ Symmetric inverse linear 1.0 -45 45 -1/45 ~ ~ ~ Cos ~ -90 90 ~ 1.0 ~ ~ Sec ~ -90 90 ~ 1.0 ~ ~ Cos_sec ~ -90 90 ~ ~ 1.0 1.0 Sec_cos ~ -90 90 ~ ~ 1.0 1.0 Hiking time ~ -70 70 ~ ~ ~ ~ Bidirectional hiking time ~ -70 70 ~ ~ ~ ~


- La sortie de l’outil [**Aspect (Exposition)**](../3d-analyst/aspect.yml) de Spatial Analyst peut être utilisée comme entrée du paramètre **Input Horizontal Raster (Raster horizontal en entrée)**.

- Les valeurs par défaut des modificateurs de facteur horizontal sont les suivantes :

&lt;!--```nohighlight
Keywords         Zero factor   Cut angle     Slope   Side value
--------------   -----------   -----------   -----   ---------
Binary           1.0            45           ~       ~
Forward          0.5            45 (fixed)   ~       1.0
Linear           0.5           181            1/90   ~
Inverse linear   2.0           180           -1/90   ~
```-->

- Les caractéristiques de la source, ou les sujets qui se déplacent à partir de ou vers une source, peuvent être contrôlés par des paramètres précis.

- **Initial Accumulation (Accumulation initiale)** définit le coût initial avant le début du mouvement.

- **Maximum Accumulation (Accumulation maximale)** spécifie le coût qu’une source peut accumuler avant d’atteindre sa limite.

- **Cost Multiplier (Multiplicateur de coût)** spécifie le mode de déplacement ou la magnitude à la source.

- **Travel Direction (Sens de déplacement)** identifie si le sujet qui se déplace commence à une source et se déplace vers les localisations non source ou s’il part des localisations non source et retourne vers une source.

- Si des paramètres des caractéristiques source sont spécifiés à l’aide d’un champ, les caractéristiques source sont appliquées source par source, selon les informations fournies dans le champ donné pour les données source. Lorsqu’un mot-clé ou une valeur constante sont donnés, ils sont appliqués à toutes les sources.

- Si la valeur **Initial Accumulation (Accumulation initiale)** est spécifiée, les localisations source sur la surface de distance de coût en sortie sont définies sur la valeur **Initial Accumulation (Accumulation initiale)**. Dans le cas contraire, les localisations source sur la distance de surface de coût en sortie sont définies sur zéro.

- Pour traiter correctement le tronçon de la projection à une étendue globale lors d’une analyse de distance à une échelle globale, assurez-vous qu’une projection cylindrique ou un système de coordonnées géographiques en sortie est utilisé conjointement avec l’option **Geodesic (Géodésique)** pour le paramètre **Distance Method (Méthode de calcul de distance)**.

- Si aucun paramètre d’environnement [Extent (Étendue)](../environment-settings/output-extent.yml) n’est défini, l’étendue de traitement est déterminée comme suit :

Si seules les valeurs **Input Raster or Feature Sources (Raster ou entités sources en entrée)** et **Input Raster or Feature Barriers (Raster ou entités d’interruption en entrée)** sont spécifiées, l’union des entrées, étendue de deux largeurs de cellule de chaque côté, est utilisée comme étendue de traitement. Le raster en sortie est étendu de deux lignes et colonnes de sorte que les sorties puissent être utilisées dans les outils [**Optimal Path As Raster (Chemin optimal comme raster)**](optimal-path-as-raster.yml) et [**Optimal Path As Line (Chemin optimal comme ligne)**](optimal-path-as-line.yml) et que les chemins générés puissent contourner les interruptions. Pour utiliser l’étendue comme interruption implicite, vous devez définir la valeur [Extent (Étendue)](../environment-settings/output-extent.yml) de manière explicite dans les paramètres d’environnement.

L’étendue de traitement est l’intersection des valeurs **Input Surface Raster (Raster de surface en entrée)**, **Input Cost Raster (Raster de coût en entrée)**, **Input Vertical Raster (Raster vertical en entrée)** ou **Input Horizontal Raster (Raster horizontal en entrée)**, le cas échéant.

- L’environnement d’analyse [Mask (Masque)](../environment-settings/mask.yml) peut être un service d’entités ou d’imagerie. Si le masque est une entité, il est converti en raster. Les cellules contenant une valeur définissent les emplacements situés dans la zone du masque. Les cellules NoData définissent les emplacements situés en dehors de la zone du masque et sont traitées comme une [interruption](../spatial-analyst/account-for-barriers-in-distance-calculations.md).

- Si les paramètres d’environnement [Cell Size (Taille de cellule)](../environment-settings/cell-size.yml) ou [Snap Raster (Raster de capture)](../environment-settings/snap-raster.yml) ne sont pas spécifiés et que plusieurs rasters sont spécifiés en tant qu’entrées, les environnements Cell Size (Taille de cellule) et Snap Raster (Raster de capture) sont définis en fonction d’un ordre de priorité : **Input Cost Raster (Raster de coût en entrée)**, **Input Surface Raster (Raster de surface en entrée)**, **Input Vertical Raster (Raster vertical en entrée)**, **Input Horizontal Raster (Raster horizontal en entrée)**, **Input Raster or Feature Sources (Raster ou entités sources en entrée)** et **Input Raster or Feature Barriers (Raster ou entités d’interruption en entrée)**.

- Reportez-vous à la rubrique [Environnements d’analyse et Spatial Analyst](../spatial-analyst/analysis-environments-and-spatial-analyst.md) pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil.

Etiqueter	Explication	Type de données
Raster ou entités sources en entrée	Emplacement des sources en entrée. Service d’imagerie ou d'entités qui identifie les cellules ou les emplacements depuis ou vers lesquels l’allocation est calculée pour chaque emplacement de cellule en sortie. Pour le service d’imagerie, le type en entrée peut être entier ou à virgule flottante. Pour un service d’entités, l’entrée peut être de type ponctuel, linéaire ou surfacique.	Raster Layer; Feature Layer
Nom du raster d’allocation de distance en sortie	Nom du service raster d’allocation de distance en sortie.	String
Raster ou entités d’interruption en entrée (Facultatif)	Jeu de données qui définit les interruptions. Les interruptions peuvent être définies par un service d’imagerie d’entiers ou à virgule flottante ou encore par un service d’entités. Pour un service d’entités, l’entrée peut être de type ponctuel, linéaire ou surfacique. Pour une interruption de service d’imagerie, l’interruption doit posséder une valeur valide, y compris zéro, et les surfaces ne constituant pas des interruptions doivent être de type NoData.	Raster Layer; Feature Layer
Raster de surface en entrée (Facultatif)	Service d'imagerie définissant les valeurs d'altitudes à chaque emplacement de cellule. Ces valeurs permettent de calculer la distance à la surface réelle qui est couverte lors du passage d’une cellule à une autre.	Raster Layer
Raster de coût en entrée (Facultatif)	Service d'imagerie définissant l'impédance ou le coût de déplacement planimétrique à travers chaque cellule. La valeur de chaque emplacement de cellule représente le coût par unité de distance du déplacement à travers la cellule. Chaque valeur d’emplacement de cellule est multipliée par la résolution de cellule (avec également une compensation simultanée pour mouvement diagonal) afin d’obtenir le coût total du passage à travers la cellule. Les valeurs du raster de coût peuvent être entières ou à virgule flottante. Les valeurs de raster de coût négatives ou nulles ne sont pas valides, mais sont traitées comme petites valeurs de coût positives.	Raster Layer
Raster vertical en entrée (Facultatif)	Service d'imagerie définissant les valeurs z de chaque emplacement de cellule. Ces valeurs permettent de calculer la pente utilisée pour identifier le facteur vertical relatif au déplacement d’une cellule à une autre.	Raster Layer
Facteur vertical (Facultatif)	Spécifie la relation entre le facteur de coût vertical et l’angle de déplacement relatif vertical (VRMA, vertical relative moving angle). Plusieurs facteurs, avec modificateurs, identifient un diagramme de facteurs verticaux défini. Les diagrammes permettent d’identifier le facteur vertical utilisé pour le calcul du coût total d’un déplacement vers une cellule voisine. Dans les descriptions ci-dessous, le facteur vertical (VF) représente la difficulté verticale rencontrée lors d’un déplacement d’une cellule vers la suivante et l’angle de déplacement relatif vertical (VRMA) représente l’angle de la pente entre la cellule FROM, ou de traitement, et la cellule TO. Les options Vertical Factor (Facteur vertical) sont les suivantes : Binary (Binaire) : si l’angle VRMA est supérieur à l’angle d’inflexion inférieur et inférieur à l’angle d’inflexion supérieur, le facteur VF doit correspondre à la valeur associée au facteur zéro ; sinon, il est infini. Linear (Linéaire) : le facteur VF est une fonction linéaire de l’angle VRMA. Symmetric Linear (Linéaire symétrique) : le facteur VF est une fonction linéaire de l’angle VRMA, du côté négatif ou du côté positif de l’angle VRMA, et les deux fonctions linéaires sont symétriques par rapport à l’axe (y) du facteur VF. Inverse Linear (Linéaire inverse) : le facteur VF est une fonction linéaire inverse de l’angle VRMA. Symmetric Inverse Linear (Linéaire inverse symétrique) : le facteur VF est une fonction linéaire inverse de l’angle VRMA, du côté négatif ou du côté positif de l’angle VRMA, et les deux fonctions linéaires sont symétriques par rapport à l’axe (y) du facteur VF. Cos : le facteur VF est une fonction cosinusoïdale de l’angle VRMA. Sec : le facteur VF est une fonction sécante de l’angle VRMA. Cos-Sec : le facteur VF est une fonction cosinusoïdale de l’angle VRMA si ce dernier est négatif et la fonction sécante de l’angle VRMA si ce dernier n’est pas négatif. Sec-Cos : le facteur VF est une fonction sécante de l’angle VRMA si ce dernier est négatif et une fonction cosinusoïdale de l’angle VRMA si ce dernier n’est pas négatif. Hiking Time (Temps de randonnée) : définit la relation entre le facteur de coût vertical et l’angle de déplacement relatif vertical via la réciproque de la fonction de Tobler, qui résulte en temps de randonnée exprimé en heures. Bidirectional Hiking Time (Temps de randonnée bidirectionnelle) : définit la relation entre le facteur de coût vertical et l’angle de déplacement relatif vertical via une fonction de randonnée bidirectionnelle. Les modificateurs des mots-clés de facteur vertical sont les suivants : Zero factor (Facteur zéro) : facteur vertical utilisé si l’angle VRMA est égal à zéro. Ce facteur positionne l’interception avec l’axe des y de la fonction spécifiée. Par définition, le facteur zéro ne s’applique à aucune fonction verticale trigonométrique (COS, SEC, COS-SEC ou SEC-COS). Ces fonctions définissent l’interception de l’axe des y. Low Cut angle (Angle d’inflexion inférieur) : angle VRMA en dessous duquel le facteur VF est défini sur l’infini. High Cut angle (Angle d’inflexion supérieur) : angle VRMA au-dessus duquel le facteur VF est défini sur l’infini. Slope (Pente) : pente en ligne droite utilisée avec les mots-clés de facteur vertical Linear (Linéaire) et Inverse Linear (Linéaire inverse). La pente est spécifiée sous forme d’un rapport de la hauteur sur la distance parcourue (par exemple, une pente de 45 pourcents correspond à 1/45, la valeur introduite étant 0,02222).	Vertical Factor
Raster horizontal en entrée (Facultatif)	Service d'imagerie définissant la direction horizontale pour chaque cellule. Les valeurs du raster doivent être des entiers compris entre 0 et 360, 0 degré correspondant au Nord (vers le haut de l’écran) et elles augmentent dans le sens horaire. La valeur -1 doit être attribuée aux surfaces planes. Les valeurs à chaque localisation sont utilisées conjointement avec le paramètre Horizontal Factor (Facteur horizontal) afin de déterminer le coût horizontal encouru lors d’un déplacement d’une cellule vers les cellules voisines.	Raster Layer
Facteur horizontal (Facultatif)	Spécifie la relation entre le facteur de coût horizontal et l’angle de déplacement relatif horizontal (HRMA, horizontal relative moving angle). Plusieurs facteurs, avec modificateurs, identifient un diagramme de facteurs horizontaux défini. Les diagrammes permettent d’identifier le facteur horizontal utilisé pour le calcul du coût total d’un déplacement vers une cellule voisine. Dans les descriptions ci-dessous, le facteur horizontal (HF) définit la difficulté horizontale rencontrée lors du déplacement d’une cellule vers la suivante. L’angle HRMA identifie l’angle entre la direction horizontale d’une cellule et la direction du déplacement. Les options Horizontal Factor (Facteur horizontal) sont les suivantes : Binary (Binaire) : si l’angle HRMA est inférieur à l’angle d’inflexion, le facteur HF a la valeur associée au facteur zéro ; dans le cas contraire, le facteur horizontal est infini. Forward (Avant) : seul un mouvement vers l’avant est autorisé. L’angle HRMA doit être supérieur ou égal à 0 et inférieur à 90 degrés (0 <= HRMA < 90). Si l’angle HRMA est compris entre 0 et 45 degrés, le facteur HF de la cellule a la valeur associée au facteur zéro. Si l’angle HRMA est supérieur ou égal à 45 degrés, la valeur du modificateur de la valeur de bord est utilisée. Le facteur HF pour un angle HRMA supérieur ou égal à 90 degrés est infini. Linear (Linéaire) : le facteur HF est une fonction linéaire de l’angle HRMA. Inverse Linear (Linéaire inverse) : le facteur HF est une fonction linéaire inverse de l’angle HRMA. Les modificateurs des facteurs horizontaux sont les suivants : Zero factor (Facteur zéro) : facteur horizontal à utiliser si la valeur HRMA est égale à zéro. Ce facteur positionne l’interception avec l’axe des y de toutes les fonctions de facteur horizontal. Cut angle (Angle d’inflexion) : angle HRMA au-delà duquel le facteur HF a une valeur infinie. Slope (Pente) : pente en ligne droite utilisée avec les mots-clés de facteur horizontal Linear (Linéaire) et Inverse Linear (Linéaire inverse). La pente est spécifiée sous forme d’un rapport de la hauteur sur la distance parcourue (par exemple, une pente de 45 pourcents correspond à 1/45, la valeur introduite étant 0,02222). Side value (Valeur de bord) : facteur HF si l’angle HRMA est supérieur ou égal à 45 degrés et inférieur à 90 degrés si le mot-clé de facteur horizontal Forward (Avant) est spécifié.	Horizontal Factor
Nom du raster d’accumulation de distance en sortie (Facultatif)	Nom du raster d’accumulation de distance en sortie. Le raster d’accumulation de distance contient la distance cumulée pour chaque cellule depuis ou vers la source de moindre coût.	String
Nom du raster de direction arrière en sortie (Facultatif)	Nom du raster de direction d’antécédence en sortie. Le raster de direction arrière contient des directions calculées en degrés. La direction identifie la cellule suivante sur le chemin optimal de retour vers la source de plus faible coût cumulé, en évitant les interruptions. La plage de valeurs est comprise entre 0 et 360 degrés. La valeur 0 est réservée aux cellules sources. La direction plein Est (droite) est de 90 degrés et les valeurs grandissent dans le sens horaire (180, Sud ; 270, Ouest et 360, Nord). Le raster en sortie est de type entier.	String
Nom du raster de direction source en sortie (Facultatif)	Nom du raster de direction source en sortie. Le raster de direction source identifie la direction de la cellule source de plus faible coût cumulé en tant qu’azimut en degrés. La plage de valeurs est comprise entre 0 et 360 degrés. La valeur 0 est réservée aux cellules sources. La direction plein Est (droite) est de 90 degrés et les valeurs grandissent dans le sens horaire (180, Sud ; 270, Ouest et 360, Nord). Le raster en sortie est de type entier.	String
Nom du raster de localisation source en sortie (Facultatif)	Nom du raster d’emplacement source en sortie. Le raster de localisation source est une sortie à plusieurs canaux. Le premier canal contient un index de ligne et le deuxième canal contient un index de colonne. Ces index identifient l’emplacement de la cellule source qui est à la distance de plus faible coût cumulé.	String
Champ source (Facultatif)	Champ permettant d’attribuer des valeurs aux emplacements source. Il doit être de type entier.	Field
Accumulation initiale (Facultatif)	Coût cumulé initial utilisé pour commencer le calcul du coût. Permet de spécifier le coût fixe associé à une source. Plutôt que de commencer avec un coût nul, l’algorithme de coût commence avec la valeur définie par le paramètre Initial accumulation (Accumulation initiale). Les valeurs doivent être égales ou supérieures à zéro. La valeur par défaut est 0.	Double; Field
Accumulation maximale (Facultatif)	Accumulation maximale pour le voyageur pour une source. Les calculs de coût continuent pour chaque source jusqu’à ce que l’accumulation spécifiée soit atteinte. Les valeurs doivent être supérieures à zéro. L’accumulation par défaut va jusqu’à la bordure du raster en sortie.	Double; Field
Multiplicateur de coût (Facultatif)	Multiplicateur appliqué aux valeurs de coût. Ce paramètre permet de contrôler le mode de déplacement ou la magnitude à une source. Plus le multiplicateur est élevé, plus le coût de déplacement d’une cellule à une autre est important. Les valeurs doivent être supérieures à zéro. La valeur par défaut est 1.	Double; Field
Sens de déplacement (Facultatif)	Indique le sens de déplacement du voyageur lorsque des facteurs horizontal et vertical sont appliqués. Si vous sélectionnez l’option String (Chaîne), vous avez le choix entre les options de départ et d’arrivée, qui sont appliquées à toutes les sources. Si vous sélectionnez l’option Field (Champ), vous pouvez sélectionner le champ des données source qui détermine le sens à utiliser pour chaque source. Le champ doit contenir la chaîne de texte `FROM_SOURCE` ou `TO_SOURCE`. Déplacement depuis la source—Les facteurs horizontal et vertical sont appliqués à partir de la source en entrée et lors du voyage vers les cellules non source. Il s’agit de l’option par défaut. Déplacement vers la source—Les facteurs horizontal et vertical sont appliqués à partir de chaque cellule non source et lors du retour à la source en entrée.	String; Field
Méthode de calcul de distance (Facultatif)	Indique si la distance est calculée avec une méthode plane (Terre plate) ou géodésique (ellipsoïde). plane—Le calcul de la distance est effectué sur une surface plane projetée à l’aide d’un système de coordonnées cartésiennes 2D. Il s’agit de l’option par défaut. Géodésique—Le calcul de la distance est effectué sur l’ellipsoïde. Les résultats ne changent pas, quelle que soit la projection en entrée ou en sortie.	String

Sortie dérivée

Etiqueter	Explication	Type de données
Raster d’allocation de distance en sortie	Raster d’allocation de distance en sortie.	Raster Layer
Raster d’accumulation de distance en sortie	Raster d’accumulation de distance en sortie.	Raster Layer
Output Back Direction Raster (Raster de direction d’antécédence en sortie)	Raster de direction d’antécédence en sortie.	Raster Layer
Raster de direction source en sortie	Raster de direction source en sortie.	Raster Layer
Raster de localisation source en sortie	Raster d’emplacement source en sortie	Raster Layer

arcpy.ra.DistanceAllocation(inputSourceRasterOrFeatures, outputDistanceAllocationRasterName, {inputBarrierRasterOrFeatures}, {inputSurfaceRaster}, {inputCostRaster}, {inputVerticalRaster}, {verticalFactor}, {inputHorizontalRaster}, {horizontalFactor}, {outputDistanceAccumulationRasterName}, {outputBackDirectionRasterName}, {outputSourceDirectionRasterName}, {outputSourceLocationRasterName}, {sourceField}, {sourceInitialAccumulation}, {sourceMaximumAccumulation}, {sourceCostMultiplier}, {sourceDirection}, {distanceMethod})

Nom	Explication	Type de données
inputSourceRasterOrFeatures	Emplacement des sources en entrée. Service d’imagerie ou d'entités qui identifie les cellules ou les emplacements depuis ou vers lesquels l’allocation est calculée pour chaque emplacement de cellule en sortie. Pour le service d’imagerie, le type en entrée peut être entier ou à virgule flottante. Pour un service d’entités, l’entrée peut être de type ponctuel, linéaire ou surfacique.	Raster Layer; Feature Layer
outputDistanceAllocationRasterName	Nom du service raster d’allocation de distance en sortie.	String
inputBarrierRasterOrFeatures (Facultatif)	Jeu de données qui définit les interruptions. Les interruptions peuvent être définies par un service d’imagerie d’entiers ou à virgule flottante ou encore par un service d’entités. Pour un service d’entités, l’entrée peut être de type ponctuel, linéaire ou surfacique. Pour une interruption de service d’imagerie, l’interruption doit posséder une valeur valide, y compris zéro, et les surfaces ne constituant pas des interruptions doivent être de type NoData.	Raster Layer; Feature Layer
inputSurfaceRaster (Facultatif)	Service d'imagerie définissant les valeurs d'altitudes à chaque emplacement de cellule. Ces valeurs permettent de calculer la distance à la surface réelle qui est couverte lors du passage d’une cellule à une autre.	Raster Layer
inputCostRaster (Facultatif)	Service d'imagerie définissant l'impédance ou le coût de déplacement planimétrique à travers chaque cellule. La valeur de chaque emplacement de cellule représente le coût par unité de distance du déplacement à travers la cellule. Chaque valeur d’emplacement de cellule est multipliée par la résolution de cellule (avec également une compensation simultanée pour mouvement diagonal) afin d’obtenir le coût total du passage à travers la cellule. Les valeurs du raster de coût peuvent être entières ou à virgule flottante. Les valeurs de raster de coût négatives ou nulles ne sont pas valides, mais sont traitées comme petites valeurs de coût positives.	Raster Layer
inputVerticalRaster (Facultatif)	Service d'imagerie définissant les valeurs z de chaque emplacement de cellule. Ces valeurs permettent de calculer la pente utilisée pour identifier le facteur vertical relatif au déplacement d’une cellule à une autre.	Raster Layer
verticalFactor (Facultatif)	L’objet Vertical Factor (Facteur vertical) définit la relation entre le facteur de coût vertical et l’angle de déplacement relatif vertical (VRMA, vertical relative moving angle). Plusieurs facteurs, avec modificateurs, identifient un diagramme de facteurs verticaux défini. Les diagrammes permettent d'identifier le facteur vertical utilisé pour le calcul du coût total d'un déplacement vers une cellule voisine. Dans les descriptions ci-dessous, le facteur vertical (VF) représente la difficulté verticale rencontrée lors d’un déplacement d’une cellule vers la suivante et l’angle de déplacement relatif vertical (VRMA) représente l’angle de la pente entre la cellule FROM, ou de traitement, et la cellule TO. L’objet se présente sous les formes suivantes : VfBinary, VfLinear, VfInverseLinear, VfSymLinear, VfSymInverseLinear, VfCos, VfSec, VfSec, VfCosSec, VfSecCos, VfHikingTime, VfBidirHikingTime, VfTable Les définitions et paramètres de ces formes sont les suivants : `VfBinary({zeroFactor}, {lowCutAngle}, {highCutAngle})` Si l’angle VRMA est supérieur à l’angle d’inflexion inférieur et inférieur à l’angle d’inflexion supérieur, le facteur VF doit correspondre à la valeur associée au facteur zéro ; sinon, il est infini. `VfLinear({zeroFactor}, {lowCutAngle}, {highCutAngle}, {slope})` Le facteur VF est une fonction linéaire de l’angle VRMA. `VfInverseLinear({zeroFactor}, {lowCutAngle}, {highCutAngle}, {slope})` Le facteur VF est une fonction linéaire inverse de l’angle VRMA. `VfSymLinear({zeroFactor}, {lowCutAngle}, {highCutAngle}, {slope})` Le facteur VF est une fonction linéaire de l’angle VRMA, du côté négatif ou du côté positif de l’angle VRMA, et les deux fonctions linéaires sont symétriques par rapport à l’axe (y) du facteur VF. `VfSymInverseLinear({zeroFactor}, {lowCutAngle}, {highCutAngle}, {slope})` Le facteur VF est une fonction linéaire inverse de l’angle VRMA, du côté négatif ou du côté positif de l’angle VRMA, et les deux fonctions linéaires sont symétriques par rapport à l’axe (y) du facteur VF. `VfCos({lowCutAngle}, {highCutAngle}, {cosPower})` Le facteur VF est une fonction cosinusoïdale de l’angle VRMA. `VfSec({lowCutAngle}, {highCutAngle}, {secPower})` Le facteur VF est une fonction sécante de l’angle VRMA. `VfCosSec({lowCutAngle}, {highCutAngle}, {cosPower}, {secPower})` Le facteur VF est une fonction cosinusoïdale de l’angle VRMA lorsque ce dernier est négatif et une fonction sécante de l’angle VRMA lorsque ce dernier n’est pas négatif. `VfSecCos({lowCutAngle}, {highCutAngle}, {secPower}, {cos_power})` Le facteur VF est une fonction sécante de l’angle VRMA lorsque ce dernier est négatif et une fonction cosinusoïdale de l’angle VRMA lorsque ce dernier n’est pas négatif. `VfHikingTime({lowCutAngle}, {highCutAngle})` Le facteur VF est une fonction de temps de randonnée de l’angle VRMA. `VfBidirHikingTime({lowCutAngle}, {highCutAngle})` Le facteur VF est une fonction de temps de randonnée modifiée bidirectionnelle de l’angle VRMA. Les modificateurs des paramètres verticaux sont les suivants : `zeroFactor`—Facteur vertical utilisé si l’angle VRMA est égal à zéro. Ce facteur positionne l’interception avec l’axe des y de la fonction spécifiée. Par définition, le facteur zéro ne s’applique à aucune fonction verticale trigonométrique (Cos, Sec, Cos-Sec ou Sec-Cos). Ces fonctions définissent l’interception de l’axe des y. `lowCutAngle`—Angle VRMA en dessous duquel la valeur du facteur VF est définie sur l’infini. `highCutAngle`—Angle VRMA au-dessus duquel la valeur du facteur VF est définie sur l’infini. `slope`—Pente d’une ligne droite utilisée avec les paramètres `VfLinear` et `VfInverseLinear`. La pente est spécifiée sous forme d’un rapport de la hauteur sur la distance parcourue (par exemple, une pente de 45 pourcents correspond à 1/45, la valeur introduite étant 0,02222).	Vertical Factor
inputHorizontalRaster (Facultatif)	Un raster définissant la direction horizontale pour chaque cellule. Les valeurs du raster doivent être des entiers compris entre 0 et 360, 0 degré correspondant au Nord (vers le haut de l’écran) et elles augmentent dans le sens horaire. La valeur -1 doit être attribuée aux surfaces planes. Les valeurs à chaque emplacement sont utilisées conjointement avec le paramètre `horizontal_factor` afin de déterminer le coût horizontal encouru lors d’un déplacement à partir d’une cellule vers les cellules voisines.	Raster Layer
horizontalFactor (Facultatif)	L’objet Horizontal factor (Facteur horizontal) définit la relation entre le facteur de coût horizontal et l’angle de déplacement relatif horizontal. Plusieurs facteurs, avec modificateurs, identifient un diagramme de facteurs horizontaux défini. Les diagrammes permettent d’identifier le facteur horizontal utilisé pour le calcul du coût total d’un déplacement vers une cellule voisine. Dans les descriptions ci-dessous, le facteur horizontal (HF) définit la difficulté horizontale rencontrée lors du déplacement d’une cellule vers la suivante. L’angle HRMA identifie l’angle entre la direction horizontale d’une cellule et la direction du déplacement. L’objet se présente sous les différentes formes suivantes : HfBinary, HfForward, HfLinear et HfInverseLinear Les définitions et paramètres de ces formes sont les suivants : `HfBinary({zeroFactor}, {cutAngle})` Si l’angle HRMA est inférieur à l’angle d’inflexion, le facteur HF a la valeur associée au facteur zéro ; dans le cas contraire, le facteur horizontal est infini. `HfForward({zeroFactor}, {sideValue})` Seul un mouvement vers l’avant est autorisé. L’angle HRMA doit être supérieur ou égal à 0 et inférieur à 90 degrés (0 <= HRMA < 90). Si l’angle HRMA est compris entre 0 et 45 degrés, le facteur HF de la cellule a la valeur associée au facteur zéro. Si l’angle HRMA est supérieur ou égal à 45 degrés, la valeur du modificateur de la valeur de bord est utilisée. Le facteur HF pour un angle HRMA supérieur ou égal à 90 degrés est infini. `HfLinear({zeroFactor}, {cutAngle}, {slope})` Le facteur HF est une fonction linéaire de l’angle HRMA. `HfInverseLinear({zeroFactor}, {cutAngle}, {slope})` Le facteur HF est une fonction linéaire inverse de l’angle HRMA. Les modificateurs des mots-clés horizontaux sont les suivants : `zeroFactor`—Facteur horizontal utilisé si la valeur HRMA est égale à 0. Ce facteur positionne l’interception avec l’axe des y de toutes les fonctions de facteur horizontal. `cutAngle`—Angle HRMA au-delà duquel le facteur HF a une valeur infinie. `slope`—Pente en ligne droite utilisée avec les mots-clés de facteur horizontal `HfLinear` et `HfInverseLinear`. La pente est spécifiée sous forme d’un rapport de la hauteur sur la distance parcourue (par exemple, une pente de 45 pourcents correspond à 1/45, la valeur introduite étant 0,02222). `sideValue`—Facteur HF si l’angle HRMA est supérieur ou égal à 45 degrés et inférieur à 90 degrés si le mot-clé de facteur horizontal `HfForward` est spécifié.	Horizontal Factor
outputDistanceAccumulationRasterName (Facultatif)	Nom du raster d’accumulation de distance en sortie. Le raster d’accumulation de distance contient la distance cumulée pour chaque cellule depuis ou vers la source de moindre coût.	String
outputBackDirectionRasterName (Facultatif)	Nom du raster de direction d’antécédence en sortie. Le raster de direction arrière contient des directions calculées en degrés. La direction identifie la cellule suivante sur le chemin optimal de retour vers la source de plus faible coût cumulé, en évitant les interruptions. La plage de valeurs est comprise entre 0 et 360 degrés. La valeur 0 est réservée aux cellules sources. La direction plein Est (droite) est de 90 degrés et les valeurs grandissent dans le sens horaire (180, Sud ; 270, Ouest et 360, Nord). Le raster en sortie est de type entier.	String
outputSourceDirectionRasterName (Facultatif)	Nom du raster de direction source en sortie. Le raster de direction source identifie la direction de la cellule source de plus faible coût cumulé en tant qu’azimut en degrés. La plage de valeurs est comprise entre 0 et 360 degrés. La valeur 0 est réservée aux cellules sources. La direction plein Est (droite) est de 90 degrés et les valeurs grandissent dans le sens horaire (180, Sud ; 270, Ouest et 360, Nord). Le raster en sortie est de type entier.	String
outputSourceLocationRasterName (Facultatif)	Nom du raster d’emplacement source en sortie. Le raster de localisation source est une sortie à plusieurs canaux. Le premier canal contient un index de ligne et le deuxième canal contient un index de colonne. Ces index identifient l’emplacement de la cellule source qui est à la distance de plus faible coût cumulé.	String
sourceField (Facultatif)	Champ permettant d’attribuer des valeurs aux emplacements source. Il doit être de type entier.	Field
sourceInitialAccumulation (Facultatif)	Coût cumulé initial utilisé pour commencer le calcul du coût. Permet de spécifier le coût fixe associé à une source. Plutôt que de commencer avec un coût nul, l’algorithme de coût commence avec une valeur définie par le paramètre `source_initial_accumulation`. Les valeurs doivent être égales ou supérieures à zéro. La valeur par défaut est 0.	Double; Field
sourceMaximumAccumulation (Facultatif)	Accumulation maximale pour le voyageur pour une source. Les calculs de coût continuent pour chaque source jusqu’à ce que l’accumulation spécifiée soit atteinte. Les valeurs doivent être supérieures à zéro. L’accumulation par défaut va jusqu’à la bordure du raster en sortie.	Double; Field
sourceCostMultiplier (Facultatif)	Multiplicateur appliqué aux valeurs de coût. Ce paramètre permet de contrôler le mode de déplacement ou la magnitude à une source. Plus le multiplicateur est élevé, plus le coût de déplacement d’une cellule à une autre est important. Les valeurs doivent être supérieures à zéro. La valeur par défaut est 1.	Double; Field
sourceDirection (Facultatif)	Indique le sens de déplacement du voyageur lorsque des facteurs horizontal et vertical sont appliqués. Spécifiez le mot-clé `FROM_SOURCE` ou `TO_SOURCE`, qui est appliqué à toutes les sources, ou spécifiez un champ dans les données source qui contient les mots-clés permettant d’identifier le sens de déplacement pour chaque source. Ce champ doit contenir la chaîne `FROM_SOURCE` ou `TO_SOURCE`. `FROM_SOURCE`—Les facteurs horizontal et vertical sont appliqués à partir de la source en entrée et lors du voyage vers les cellules non source. Il s’agit de l’option par défaut. `TO_SOURCE`—Les facteurs horizontal et vertical sont appliqués à partir de chaque cellule non source et lors du retour à la source en entrée.	String; Field
distanceMethod (Facultatif)	Indique si la distance est calculée avec une méthode plane (Terre plate) ou géodésique (ellipsoïde). `PLANAR`—Le calcul de la distance est effectué sur une surface plane projetée à l’aide d’un système de coordonnées cartésiennes 2D. Il s’agit de l’option par défaut. `GEODESIC`—Le calcul de la distance est effectué sur l’ellipsoïde. Les résultats ne changent pas, quelle que soit la projection en entrée ou en sortie.	String

Sortie dérivée

Nom	Explication	Type de données
outputDistanceAllocationRaster	Raster d’allocation de distance en sortie.	Raster Layer
outputDistanceAccumulationRaster	Raster d’accumulation de distance en sortie.	Raster Layer
outputBackDirectionRaster	Raster de direction d’antécédence en sortie.	Raster Layer
outputSourceDirectionRaster	Raster de direction source en sortie.	Raster Layer
outputSourceLocationRaster	Raster d’emplacement source en sortie	Raster Layer

Exemple de code

Exemple 1 d’utilisation de l’outil DistanceAllocation (fenêtre Python)

Le script de fenêtre Python ci-aprè illustre l’utilisation de l’outil DistanceAllocation.

import arcpy

arcpy.ra.DistanceAllocation('https://MyPortal.esri.com/server/rest/services/Hosted/sources/ImageServer',
                            'outDistanceAllocation',
                            'https://MyPortal.esri.com/server/rest/services/Hosted/barrier/ImageServer',
                            'https://MyPortal.esri.com/server/rest/services/Hosted/surface/ImageServer',
                            'https://MyPortal.esri.com/server/rest/services/Hosted/cost/ImageServer')

Exemple 2 d’utilisation de l’outil DistanceAllocation (script autonome)

Calcule, pour chaque cellule, la distance de plus faible coût cumulé jusqu’à la source la plus proche, tout en tenant compte de la distance de surface et des facteurs de coût horizontaux et verticaux.

# Name: DistanceAllocation_Ex_02.py
# Description: Calculates the distance allocation.
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inputSourceRasterOrFeatures = 'https://MyPortal.esri.com/server/rest/services/Hosted/sources/ImageServer'
outputDistanceAllocationRasterName = "outDistAllo"
inputBarrierRasterOrFeatures  = 'https://MyPortal.esri.com/server/rest/services/Hosted/barrier/ImageServer'
inputSurfaceRaster = 'https://MyPortal.esri.com/server/rest/services/Hosted/surface/ImageServer'
inputCostRaster = 'https://MyPortal.esri.com/server/rest/services/Hosted/cost/ImageServer'
inputVerticalRaster = 'https://MyPortal.esri.com/server/rest/services/vertical/sources/ImageServer'
verticalFactor = ""
inputHorizontalRaster = 'https://MyPortal.esri.com/server/rest/services/Hosted/horizontal/ImageServer'
horizontalFactor = ""
outputDistanceAccumulationRasterName = "outAccum"
outputBackDirectionRasterName = "outBackDir"
outputSourceDirectionRasterName = "outSourceDir"
outputSourceLocationRasterName = "outSourceLocation"
sourceField = "SourceID"
sourceInitialAccumulation = "IntitalAccum"
sourceMaximumAccumulation = "500000"
sourceCostMultiplier = "CostMultiplier"
sourceDirection = "FROM_SOURCE"
distanceMethod = "PLANAR"

# Run
arcpy.ra.DistanceAllocation(inputSourceRasterOrFeatures, outputDistanceAllocationRasterName,
                            inputBarrierRasterOrFeatures, inputSurfaceRaster,
                            inputCostRaster, inputVerticalRaster, verticalFactor,
                            inputHorizontalRaster, horizontalFactor,
                            outputDistanceAccumulationRasterName, outputBackDirectionRasterName,
                            outputSourceDirectionRasterName, outputSourceLocationRasterName,
                            sourceField, sourceInitialAccumulation, sourceMaximumAccumulation,
                            sourceCostMultiplier, sourceDirection, distanceMethod)

Environnements

Etendue, Taille de cellule, Masque, Système de coordonnées en sortie, Pyramide, Raster de capture

Informations de licence

Basic: Requiert ArcGIS Image Server
Standard: Requiert ArcGIS Image Server
Advanced: Requiert ArcGIS Image Server

Allocation de distance (Outils d'analyse raster)

Résumé

Illustration

Utilisation

Paramètres

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes