Accumulation de distance (Map Viewer Classic)

L’outil Accumulation de distance calcule la distance cumulée à partir de chaque cellule vers les sources en entrée.

Diagramme de workflow

Exemples

Cet outil permet, par exemple, d’apporter une réponse aux questions suivantes :

• À quelle distance se trouve la ville plus proche ?
• Quelle est la distance de coût par rapport à la route la plus proche ?
• Quelle est la distance autour des interruptions par rapport à la source d’eau la plus proche ?

Remarques sur l’utilisation

Les données source en entrée peuvent être une classe d’entités ou un raster. La classe d’entités peut être ponctuelle, linéaire ou surfacique.

Lorsque les données source en entrée correspondent à un raster, 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.

Si les données source en entrée correspondent à une entité, les emplacements source sont convertis en interne en raster avant l’analyse. La résolution du raster peut être contrôlée à l'aide du paramètre d'environnement 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 petite 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 250.

Pour éviter cette situation, vous pouvez entre-temps effectuer la rasterisation des entités en entrée directement avec l'outil Convert Feature to Raster (Convertir l’entité en 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.

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.

Si le raster de surface en entrée possède un système de coordonnées verticales, les valeurs du raster de surface sont considérées comme étant exprimées dans les unités du système de coordonnées verticales. Si le raster de surface en entrée n’a pas de 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 le raster de surface en entrée n’a 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 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 interruptions sont des obstacles qui doivent être contournés. Elles peuvent être définies de deux façons.

Pour le paramètre Choose barrier raster or feature (Choisir une entité ou un raster d’interruption), les interruptions peuvent être représentées, soit par des cellules qui contiennent une valeur admise, soit 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 emplacements où aucune cellule NoData n’existe dans les entrées suivantes : Choose cost raster (Choisir un raster de coût), Choose surface raster (Choisir un raster de surface), Choose vertical raster (Choisir un raster vertical) et Choose horizontal raster (Choisir un raster horizontal). À 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.

Le raster de coût ne peut pas contenir de valeurs nulles, puisque l'algorithme est un processus multiplicatif. Si votre raster de coût contient des valeurs nulles et que ces valeurs représentent des surfaces de plus faible coût, remplacez ces cellules par une petite valeur positive (comme 0,01) avant d'exécuter cet outil.

Les valeurs par défaut des modificateurs Vertical factor (Facteur vertical) sont les suivantes :

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

La sortie de l’outil Déduire l’exposition peut être utilisée comme entrée du paramètre Choose horizontal raster (Choisir un raster horizontal).

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

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.
• Multiplier to apply to costs (Multiplicateur à appliquer aux coûts) spécifie le mode de déplacement ou la magnitude à la source.
• L’option Travel direction (Sens de déplacement) identifie si le sujet qui se déplace commence à une source et se déplace vers les emplacements non source ou s’il commence aux emplacements 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 Initial accumulation (Accumulation initiale) est spécifié, les emplacements source sur la surface de distance de coût en sortie sont définis sur la valeur Initial accumulation (Accumulation initiale). Dans le cas contraire, les emplacements source sur la distance de surface de coût en sortie sont définis sur zéro.

Lorsqu’aucun paramètre d’environnement Étendue n’est défini, l’étendue de traitement est déterminée comme suit :

Si seules les données source et d’interruption 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 pour que les chemins générés puissent contourner les limites lorsque les sorties peuvent être utilisées dans Optimal Path As Raster (Chemin optimal comme raster) et Optimal Path As Line (Chemin optimal comme ligne). Pour utiliser l’étendue comme interruption implicite, vous devez définir la valeur Extent (Étendue) de manière explicite dans les paramètres d’environnement.

L’étendue de traitement est l’intersection du raster de surface, du raster de coût, du raster vertical ou du raster horizontal, le cas échéant.

L’environnement d’analyse Mask (Masque) peut être défini sur une classe d’entités ou un jeu de données raster. 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 des interruptions.

Si les paramètres d’environnement Cell Size (Taille de cellule) ou Snap Raster (Raster de capture) ne sont pas spécifiés et que plusieurs rasters sont spécifiés comme entrées, les paramètres Cell Size (Taille de cellule) et Snap Raster (Raster de capture) sont définis par ordre de priorité : raster de coût, raster de surface, raster vertical, raster horizontal, données source et données d’interruption.

Les paramètres de cet outil sont indiqués dans la table suivante :

Paramètre	Explication
Choisir des entités ou un raster source	Couche d’entités ou raster qui identifie les sources par rapport auxquelles la distance va être calculée. Si l’entrée est un raster, il doit comporter des cellules qui ont des valeurs valides (zéro est une valeur valide) pour les sources, et les cellules restantes doivent avoir la valeur NoData. Si l’entité est une couche d’entités, il peut s’agir d’un point, d’une ligne ou d’un polygone.
Choisir une entité ou un raster d’interruption (facultatif)	Jeu de données qui définit les interruptions. Pour un raster, le type en entrée peut être entier ou à virgule flottante. Toutes les cellules dotées d’une valeur (y compris zéro) sont traitées comme une interruption. Les cellules dotées d’une valeur NoData ne sont pas traitées comme une interruption. Pour le service d’entités, l’entrée peut être de type ponctuel, linéaire ou surfacique.
Choisir un raster de surface (facultatif)	Indique si la distance est calculée avec une méthode plane (Terre plate) ou géodésique (ellipsoïde). Ces valeurs permettent de calculer la distance à la surface réelle qui est couverte lors du passage d'une cellule à une autre.
Choisir un raster de coût (facultatif)	Raster 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 des entiers ou valeurs à virgule flottante, mais elles ne peuvent pas être négatives ni nulles (un coût ne peut pas être négatif ou nul).
Choisir un raster vertical (facultatif)	Un raster définissant les valeurs z pour 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.
Facteur vertical (facultatif)	Le paramètre Vertical factor (Facteur vertical) définit la relation entre le facteur de coût vertical (VF) et l’angle de déplacement relatif vertical (VRMA). Cette option n’est disponible que si l’option Choose vertical raster (optional) (Choisir un raster vertical (facultatif)) est spécifiée. 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) définit la difficulté rencontrée lors du déplacement d’une cellule vers la suivante, et le modificateur VRMA identifie l’angle de la pente entre la cellule From source (À partir de la source) et la cellule To source (Vers la source). 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. Inverse linear (Linéaire inverse) : indique que le facteur VF est une fonction linéaire inverse de l’angle VRMA. Symmetric linear (Linéaire symétrique) : le facteur VF est une fonction linéaire de l’angle VRMA, à la fois du côté négatif et 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. Symmetric inverse linear (Linéaire inverse symétrique) : le facteur VF est une fonction linéaire inverse de l’angle VRMA, à la fois du côté négatif et 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 lorsque ce dernier est négatif et la fonction sécante de l’angle VRMA lorsque ce dernier n’est pas négatif. Sec-Cos : 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. Les modificateurs des paramètres verticaux sont les suivants : Zero factor (Facteur zéro) : le facteur vertical utilisé lorsque 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) : l’angle VRMA en dessous duquel le facteur VF est défini sur l’infini. High cut angle (Angle d’inflexion supérieur) : l’angle VRMA au-dessus duquel le facteur VF est défini sur l’infini. Slope (Pente) : la pente de la ligne droite utilisée avec les paramètres 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).
Choisir un raster horizontal (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 seront utilisées conjointement avec le paramètre Horizontal factor (Facteur horizontal) afin de déterminer le coût horizontal induit lors d’un déplacement à partir d’une cellule vers les cellules voisines.
Facteur horizontal (facultatif)	Le paramètre Horizontal factor (Facteur horizontal) définit la relation entre le facteur de coût horizontal et l’angle de déplacement relatif horizontal. Cette option n’est disponible que si l’option Choose horizontal raster (optional) (Choisir un raster horizontal (facultatif)) est spécifiée. 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 définitions et paramètres de ces facteurs horizontaux sont indiqués ci-dessous : 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) : indique que le facteur HF est une fonction linéaire inverse de l’angle HRMA. Les modificateurs des mots-clés horizontaux sont les suivants : Zero factor (Facteur zéro) : facteur horizontal à utiliser lorsque 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) : l’angle HRMA au-delà duquel le facteur HF a une valeur infinie. Slope (Pente) : la pente de la 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) : le facteur HF lorsque l’angle HRMA est supérieur ou égal à 45 degrés et inférieur à 90 degrés lorsque le mot-clé de facteur horizontal Forward (Avant) est spécifié.
Initial accumulation (Accumulation initiale) (facultatif)	Coût cumulé initial utilisé pour commencer le calcul du coût. Ce paramètre 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.
Maximum accumulation (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.
Cost multiplier (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.
Travel direction (Sens de déplacement) (facultatif)	Indique le sens de déplacement du voyageur lorsque des facteurs horizontal et vertical sont appliqués. From source (À partir de la source) : le facteur horizontal et le facteur vertical sont appliqués à partir de la source en entrée et lors du déplacement vers les cellules non source. Il s’agit de l’option par défaut. To source (Vers la source) : le facteur horizontal et le facteur vertical sont appliqués à partir de chaque cellule non source et lors du retour à la source en entrée. Spécifiez le mot-clé From source (À partir de la source) ou To source (Vers la 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.
Méthode de distance (facultatif)	Indique si la distance est calculée avec une méthode plane (Terre plate) ou géodésique (ellipsoïde). Planar (Planaire) : le calcul est effectué sur une surface plane projetée à l’aide d’un système de coordonnées cartésiennes 2D. Il s'agit de la méthode par défaut. Geodesic (Géodésique) : le calcul de la distance s’opère sur l’ellipsoïde. Les résultats ne changent pas, quelle que soit la projection en entrée ou en sortie.
Le nom du raster d’accumulation de distance de résultat.	Le raster d’accumulation de distance contient la distance cumulée pour chaque cellule depuis ou vers la source de moindre coût. Le raster en sortie est de type entier. Le nom de la couche qui sera créée dans la page My Content (Mon contenu) et ajoutée à la carte. Le nom par défaut repose sur le nom de l'outil et sur le nom de la couche en entrée. Si la couche existe déjà, vous êtes invité à fournir un autre nom. Vous pouvez spécifier le nom d’un dossier dans My Content (Mon contenu), dans lequel le résultat sera enregistré via la zone de liste déroulante Save result in (Enregistrer le résultat dans).
Le nom du raster de direction arrière de résultat (facultatif)	Le raster de direction arrière contient la direction calculée, en degrés. La direction identifie la cellule suivante le long du chemin de retour le plus court vers la source la plus proche tout en évitant les interruptions. La plage de valeurs s'étend de 0 à 360 degrés, 0 étant réservé pour aux cellules source. La direction plein Est (droite) est de 90 et les valeurs augmentent dans le sens horaire (180, Sud ; 270, Ouest et 360, Nord). Le raster en sortie est de type entier. Le nom de la couche qui sera créée dans la page My Content (Mon contenu) et ajoutée à la carte. Le nom par défaut repose sur le nom de l'outil et sur le nom de la couche en entrée. Si la couche existe déjà, vous êtes invité à fournir un autre nom. Vous pouvez spécifier le nom d’un dossier dans My Content (Mon contenu), dans lequel le résultat sera enregistré via la zone de liste déroulante Save result in (Enregistrer le résultat dans).
Le nom du raster de direction source de résultat (facultatif)	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 s'étend de 0 à 360 degrés, 0 étant réservé pour aux cellules source. La direction plein Est (droite) est de 90 et les valeurs augmentent dans le sens horaire (180, Sud ; 270, Ouest et 360, Nord). Le raster en sortie est de type entier. Le nom de la couche qui sera créée dans la page My Content (Mon contenu) et ajoutée à la carte. Le nom par défaut repose sur le nom de l'outil et sur le nom de la couche en entrée. Si la couche existe déjà, vous êtes invité à fournir un autre nom. Vous pouvez spécifier le nom d’un dossier dans My Content (Mon contenu), dans lequel le résultat sera enregistré via la zone de liste déroulante Save result in (Enregistrer le résultat dans).
Le nom du raster de localisation source de résultat (facultatif)	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é. Le nom de la couche qui sera créée dans la page My Content (Mon contenu) et ajoutée à la carte. Le nom par défaut repose sur le nom de l'outil et sur le nom de la couche en entrée. Si la couche existe déjà, vous êtes invité à fournir un autre nom. Vous pouvez spécifier le nom d’un dossier dans My Content (Mon contenu), dans lequel le résultat sera enregistré via la zone de liste déroulante Save result in (Enregistrer le résultat dans).

Environnements

Les paramètres d’environnement d’analyse sont des paramètres supplémentaires qui affectent les résultats d’un outil. Vous pouvez accéder aux paramètres d’environnement d'analyse de l'outil en cliquant sur l'icône représentant un engrenage dans la partie supérieure de la fenêtre de l'outil.

Cet outil respecte les environnements d’analyse suivants :

• Système de coordonnées en sortie : indique le système de coordonnées de la couche en sortie.
• Étendue : indique la surface à utiliser pour l’analyse.
• Raster de capture : ajuste l’étendue de sortie afin qu’elle corresponde à l’alignement des cellules de la couche Snap Raster (Raster de capture) spécifiée.
• Taille de cellule : taille de cellule à utiliser dans la couche en sortie.
• Masque : désigne une couche de masque, où seules les cellules qui se trouvent dans la zone du masque seront utilisées pour l’analyse.
• Facteur de traitement parallèle : contrôle les instances CPU ou GPU du traitement parallèle.

Fonctions raster et outils similaires

L’outil Accumulation de distance calcule la distance cumulée à partir de chaque cellule vers les sources en entrée. D’autres outils peuvent vous aider à résoudre des problèmes similaires.

Outils d’analyse et fonctions raster dans Map Viewer Classic

Utilisez l’outil Allocation de distance ou la fonction raster Distance Allocation (Allocation de distance) si une sortie du service d’imagerie d’allocation de distance est requise.

L’outil Accumulation de distance est également disponible sous forme de fonction raster.

Fonctions raster et outils d’analyse ArcGIS Pro

Les outils de géotraitement Accumulation de distance et Allocation de distance sont disponibles dans la boîte à outils Spatial Analyst.

Les outils de géotraitement Accumulation de distance et Allocation de distance sont disponibles dans la boîte à outils Analyse raster.

Accumulation de distance et Allocation de distance sont disponibles en tant que fonctions raster.

Ressources destinées aux développeurs ArcGIS Enterprise

Si vous utilisez ArcGIS REST API, utilisez les tâches Distance Accumulation et Distance Allocation.

Si vous utilisez ArcGIS API for Python, utilisez distance_accumulation et distance_allocation à partir du module arcgis.raster.functions.gbl.