Fonction d’allocation de distance

Disponible avec une licence Spatial Analyst.

Vue d’ensemble

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 les facteurs horizontaux et verticaux de coût.

Il s’agit d’une fonction raster globale.

Remarques

Si vous avez des entités source, vous pouvez d’abord les convertir en un jeu de données raster à l’aide de la fonction Rasteriser les entités. Utilisez une entrée cohérente comme raster pour cette fonction. Vous aurez ainsi l’assurance que les entités sont converties correctement en jeu de données raster avec les mêmes paramètres (taille de cellule, étendue des données et référence spatiale).

Les valeurs NoData présentes dans le raster source ne sont pas incluses comme valeurs valides de la fonction. La valeur 0 est considérée comme une valeur normale du raster de la source. Un raster source peut être créé à l’aide des outils d’extraction ou de la fonction Découper.

Si l’élément 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 l’élément Surface Raster (Raster de surface) en entrée ne comporte pas de VCS et que les données sont projetées, les valeurs de surface sont considérées comme étant exprimées dans les unités linéaires de la référence spatiale. Si l’élément Surface Raster (Raster de surface) en entrée ne comporte pas de VCS 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.

Si aucun paramètre d'environnement Extent (Étendue) n’est spécifié, l’étendue du traitement est déterminée de la manière suivante :

• Si seules les données Input raster or feature source data (Données raster ou vecteur source en entrée) et Input barrier raster or feature data (Données d’entité ou raster 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 soient utilisées dans Optimal Path As Line (Chemin optimal comme ligne) et Optimal Path As Raster (Chemin optimal comme raster). Les chemins générés peuvent contourner les interruptions. Pour utiliser l’étendue comme interruption implicite, vous devez définir l’option Extent (Étendue) de manière explicite dans les paramètres d’environnement.

• Si l’un des jeux de données de raster 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) est spécifié, l’étendue de traitement correspond à l’intersection de ces rasters.

Si les paramètres d’environnement Cell Size (Taille de cellule) et 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 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 source data (Données raster ou vecteur source en entrée) et Input barrier raster or feature data (Raster d’interruption ou données d’entités en entrée).

Pour le raster en sortie, la distance de plus faible coût (ou distance de coût cumulée minimale) d’une cellule à un ensemble d’emplacements source correspond à la limite inférieure des distances de plus faible coût de la cellule à tous les emplacements source.

Les valeurs par défaut des modificateurs de 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 la fonction Aspect peut être utilisée comme entrée pour Input horizontal raster (Raster horizontal en entrée).

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   ~

Cochez l’option booléenne Generate source row and column as additional bands in output (Générer une ligne et une colonne source en tant que canaux supplémentaires en sortie) produira un raster multicanal composé de trois canaux. Le premier canal est le canal d’allocation de distance, le second contient un index de lignes, et le troisième canal un index de colonnes. Ces index identifient l’emplacement de la cellule source qui se trouve à la distance de plus faible coût cumulé. L’index de lignes source et l’index de colonnes source peuvent être utilisés ensemble pour réaliser une cartographie d’intensité. Effectuez une requête sur un emplacement de votre zone d’étude à travers les canaux deux et trois, pour connaître la ligne et la colonne de la source de moindre coût pour cet emplacement.

Si des paramètres de caractéristiques de la source sont spécifiés à l’aide d’une valeur, celle-ci est appliquée à toutes les sources. Si les paramètres sont spécifiés via des champs associés au raster source, les valeurs de la table seront appliquées uniquement aux sources correspondantes.

• Initial accumulation (Accumulation initiale) définit le coût de départ avant que le déplacement ne commence.
• Maximum accumulations (Accumulations maximales) indique 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.
• 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 part des emplacements non source et retourne vers une source.

Cette fonction prend en charge le traitement parallèle. Il est possible d’obtenir de meilleures performances, en particulier sur les jeux de données volumineux, si votre ordinateur est doté de plusieurs processeurs ou de processeurs multicœurs. Pour plus d’informations concernant cette fonctionnalité et sa configuration, reportez-vous à la rubrique Traitement parallèle avec Spatial Analyst.

Lorsque vous utilisez le traitement parallèle, les données temporaires sont écrites pour gérer les blocs de données en cours de traitement. L’emplacement par défaut du dossier temporaire se trouve sur votre disque local C. Vous pouvez contrôler l’emplacement de ce répertoire en définissant une variable d’environnement système appelée TempFolders et en spécifiant le chemin d’accès du répertoire à utiliser (par exemple, E:\RasterCache). Si vous disposez de privilèges administrateur sur votre ordinateur, vous pouvez également utiliser une clé du Registre (par exemple, [HKEY_CURRENT_USER\SOFTWARE\ESRI\ArcGISPro\Raster]).

Par défaut, cette fonction utilise 50 pourcent des cœurs disponibles. Si les données en entrée sont inférieures à 5 000 par 5 000 cellules, le nombre de cœurs utilisé peut être moindre. Vous pouvez contrôler le nombre de cœurs que l’outil utilise à l’aide de l’environnement Facteur de traitement parallèle.

Paramètres

Nom de paramètre	Description
Raster source (Requis)	Emplacement des sources en entrée. Jeu de données raster qui identifie les cellules ou les emplacements depuis ou vers lesquels la distance de moindre coût cumulé est calculée pour chaque emplacement de cellule en sortie.
Champ source	Champ permettant d’attribuer des valeurs aux emplacements source. Il doit être de type entier.
Interruptions du raster	Raster qui définit les interruptions. Le jeu de données doit contenir une valeur NoData lorsqu’il n’y a pas d’interruption. Les interruptions sont représentées par des valeurs valides, y compris zéro. Les interruptions peuvent être définies par un entier ou un raster à virgule flottante.
Surface raster	Un raster 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 de coût	Raster définissant le coût ou l’impédance de déplacement planimétrique à travers chaque cellule. La valeur à chaque emplacement de cellule représente le coût par unité de distance pour le déplacement à travers chaque cellule. Chaque valeur d’emplacement de cellule est multipliée par la résolution de cellule et compense également le 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.
Raster 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). 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	Définit la relation entre le facteur de coût vertical et l'angle de déplacement relatif vertical (VRMA, vertical relative moving angle). Vous pouvez choisir parmi plusieurs facteurs, avec modificateurs, qui renvoient à un diagramme de facteurs verticaux défini. En outre, vous pouvez utiliser une table pour créer un diagramme personnalisé. 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 explications ci-dessous, deux acronymes sont utilisés. VF et VRMA. Le facteur VF correspond au facteur vertical, lequel représente la difficulté verticale rencontrée lors d’un déplacement d’une cellule vers la suivante. L’angle VRMA correspond à l’angle de déplacement relatif vertical, lequel représente l’angle de la pente entre la cellule FROM, ou de traitement, et la cellule TO. Les types de facteur vertical sont les suivants : Binaire - Spécifie que 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. Linéaire - Indique que le facteur VF est une fonction linéaire de l'angle VRMA. Linéaire symétrique - Spécifie que 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, respectivement, et que les deux fonctions linéaires sont symétriques par rapport à l'axe (y) du facteur VF. Linéaire inverse - Indique que le facteur VF est une fonction linéaire inverse de l'angle VRMA. Linéaire inverse symétrique - Spécifie que 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, respectivement, et que les deux fonctions linéaires sont symétriques par rapport à l'axe (y) du facteur VF. Cos - Identifie le facteur VF comme une fonction cosinusoïdale de l'angle VRMA. Sec - Identifie le facteur VF comme une fonction sécante de l'angle VRMA. Cos-Sec - Indique que le facteur VF est une fonction cosinusoïdale de l'angle VRMA lorsque ce dernier est négatif et qu'il est une fonction sécante de l'angle VRMA lorsque ce dernier n'est pas négatif. Sec-Cos - Indique que le facteur VF est une fonction sécante de l'angle VRMA lorsque ce dernier est négatif et qu'il est une fonction cosinusoïdale de l'angle VRMA lorsque ce dernier n'est pas négatif. Table - Indique qu'un fichier de table sera utilisé pour définir le diagramme des facteurs verticaux qui permettra de déterminer les facteurs VF. Les modificateurs des mots-clés de facteur vertical sont les suivants : Facteur zéro - Définit le facteur vertical utilisé lorsque l'angle VRMA est nul. 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. Angle d'inflexion inférieur - Définit l'angle VRMA en dessous duquel le facteur VF est défini sur l'infini. Angle d'inflexion supérieur - Définit l'angle VRMA au-dessus duquel le facteur VF est défini sur l'infini. Pente : établit la pente d'une ligne droite utilisée avec les mots-clés de facteur vertical Linéaire et 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). Nom de la table - Identifie le nom de la table définissant le facteur VF.
Raster horizontal	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 au facteur horizontal afin de déterminer le coût horizontal encouru lors d'un déplacement à partir d'une cellule vers les cellules voisines.
Facteur horizontal	Définit la relation entre le facteur de coût horizontal et l'angle de déplacement relatif horizontal (HRMA, horizontal relative moving angle). Vous pouvez choisir parmi plusieurs facteurs, avec modificateurs, qui renvoient à un diagramme de facteurs verticaux défini. En outre, vous pouvez utiliser une table pour créer un diagramme personnalisé. 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 explications ci-dessous, deux acronymes sont utilisés. HF et HRMA. Le facteur HF correspond au facteur horizontal qui représente la difficulté horizontale rencontrée lors d’un déplacement d’une cellule vers la suivante. L’angle HRMA correspond à l’angle de déplacement relatif horizontal, lequel représente l’angle entre la direction horizontale d’une cellule et la direction du déplacement. Les types de facteur horizontal sont les suivants : Binaire - Indique que 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. Avant - Précise que 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 égal ou supérieur à 90 degrés correspond à l’infini. Linéaire - Spécifie que le facteur HF est une fonction linéaire de l'angle HRMA. Linéaire inverse - Spécifie que le facteur HF est une fonction linéaire inverse de l'angle HRMA. Table - Indique qu'un fichier de table sera utilisé pour définir le diagramme des facteurs horizontaux permettant de déterminer les facteurs HF. Les modificateurs des facteurs horizontaux sont les suivants : Facteur zéro - Définit le 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. Angle d'inflexion - Définit l'angle HRMA au-delà duquel le facteur HF a une valeur infinie. Slope : définit la pente en ligne droite utilisée avec les mots-clés de facteur horizontal Linéaire et 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). Valeur de bord : définit 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 Suivant est spécifié. Nom de la table - Correspond au nom de la table définissant le facteur HF.
Source Row and Column Bands (Canaux de ligne et colonne source)	Détermine si seul le raser d’allocation est créé ou si un résultat multicanal est également créé. Décoché : le résultat est le raster d’allocation de distance. Il s’agit d’un résultat à un seul canal. Il s’agit de l’option par défaut. Coché : un raster multicanal est créé. Le premier canal est le raster d’allocation de distance, le second contient un index de lignes, et le troisième canal un index de colonnes. Ces index identifient l’emplacement de la cellule source qui se trouve à la distance de plus faible coût cumulé.
Accumulation initiale	Coût cumulé initial 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 égal à 0, l’algorithme de coût commence avec la valeur définie. Une valeur numérique (double) ou un champ du raster source peut être utilisé pour ce paramètre. La valeur doit être égale ou supérieure à zéro. La valeur par défaut est 0.
Accumulation maximale	Définit le coût cumulé maximal pour le voyageur pour une source. Les calculs de coût continuent pour chaque source jusqu’à ce que la capacité spécifiée soit atteinte. Une valeur numérique (double) ou un champ du raster source peut être utilisé pour ce paramètre. La valeur doit être supérieure à zéro. La capacité par défaut est limitée par le tronçon du raster en sortie.
Multiplicateur à appliquer aux coûts	Multiplicateur à appliquer 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. Une valeur numérique (double) ou un champ du raster source peut être utilisé pour ce paramètre.
Sens de déplacement	Définit la direction du voyageur en cas d’application du facteur vertical, du facteur horizontal et du taux de résistance source. From Source (À partir de la source) : le facteur vertical, le facteur horizontal et le taux de résistance source sont appliqués de la source en entrée jusqu’aux cellules non source. Il s’agit de l’option par défaut. To Source (Vers la source) : le facteur vertical, le facteur horizontal et le taux de résistance source sont appliqués de chaque cellule non source jusqu’à la source en entrée. Spécifiez le mot-clé A partir de la source ou Vers la source, qui est appliqué à toutes les sources, ou spécifiez un champ dans le raster 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 calcul de distance	Détermine si la distance doit être calculée avec une méthode plane (Terre plate) ou géodésique (ellipsoïde). Plane : la mesure plane utilise des mathématiques cartésiennes en 2D pour calculer la longueur et la surface. Cette option est uniquement disponible lorsque les mesures sont effectuées dans un système de coordonnées projetées. Le plan 2D de ce système de coordonnées est alors utilisé comme base des mesures. Géodésique : ligne la plus courte entre deux points d’un sphéroïde (ellipsoïde) sur la surface de la Terre. Les résultats ne changent donc pas quelle que soit la projection en entrée ou en sortie. Remarque : Vous pouvez utiliser une ligne géodésique si vous souhaitez déterminer la distance la plus courte entre deux villes pour la trajectoire de vol d’un avion. On parle également de « ligne de grand cercle » si elle repose sur une sphère plutôt qu'une ellipsoïde.

Paramètres d'environnement

Les paramètres d’environnement de géotraitement pour les fonctions globales sont contrôlés au niveau de l’application. Pour configurer des environnements de traitement dans ArcGIS Pro, cliquez sur le bouton Environments (Environnements) sur l’onglet Analysis (Analyse). Reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst pour en savoir plus sur les paramètres d’environnement.

Les environnements suivants sont pris en charge par cette fonction globale :

• Validation automatique
• Taille de cellule
• Compression
• Espace de travail courant
• Etendue
• Transformations géographiques
• Masque
• Mot-clé CONFIG en sortie
• Système de coordonnées en sortie
• Statistiques raster
• Espace de travail temporaire
• Raster de capture
• Taille de tuile