Allocation de distance (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

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.

En savoir plus sur le fonctionnement de l’outil Accumulation de distance

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. Vous pouvez créer un raster source à l’aide des outils d’extraction.

  • Lorsque les données source en entrée correspondent à une classe d'entités, 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.

  • Lorsque vous utilisez des données d’entité pour les données source en entrée, vous devez traiter la taille de cellule en sortie avec prudence si elle est grossière par rapport au détail dans l’entrée. Le processus de rastérisation interne utilise la même valeur par défaut Cell assignment type (Type d’attribution de cellule) que l’outil Entité vers raster, à savoir la méthode Centre de cellule. Cela signifie que les données ne figurant pas au centre de la cellule ne seront pas incluses dans la sortie source rastérisée intermédiaire ; elles ne seront donc pas représentées dans les calculs de distance. Par exemple, si les sources sont représentées par une série de petits polygones (tels que des emprises de bâtiments) dont la taille est petite par rapport à la taille de cellule en sortie, il se peut que quelques-uns de ces polygones seulement apparaissent aux centres des cellules raster en sortie et que, vraisemblablement, la plupart des autres polygones soient perdus et exclus de l’analyse.

    Pour éviter cette situation, vous pouvez entre-temps effectuer la rastérisation des entités en entrée directement avec l’outil 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 barrier raster or feature data (Raster d’interruption ou données d’entités en entrée), 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 : 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) 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 la valeur Input surface raster (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 la valeur Input surface raster (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.

  • 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.

  • 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 l’outil Aspect peut être utilisée comme entrée pour le paramètre 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   ~
  • 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 valeurs 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) sont renseignées, l’union des entrées, étendue par 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 Chemin optimal comme ligne et 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 la valeur Extent (Étendue) de manière explicite dans les paramètres d’environnement.

    L’étendue de traitement est l’intersection des champs 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) peut être défini sur une entité 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 une interruption.

  • 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 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 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).

  • Cet outil 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, consultez la rubrique d’aide 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 C:. Vous pouvez contrôler l’emplacement de ce dossier en définissant une variable d’environnement système appelée TempFolders et en spécifiant le chemin d’accès du dossier à utiliser (par exemple, E:\RasterCache). Si vous disposez de privilèges d’administrateur sur votre ordinateur, vous pouvez également utiliser une clé de registre (par exemple, [HKEY_CURRENT_USER\SOFTWARE\ESRI\ArcGISPro\Raster]).

    Par défaut, cet outil utilise 50 pour cent des cœurs disponibles. Si les données en entrée sont inférieures à 5 000 par 5 000 cellules en taille, le nombre de cœurs utilisés 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.

  • Lorsque le format raster en sortie est .crf, cet outil prend en charge l’environnement de stockage raster Pyramide. Des pyramides seront créées dans la sortie par défaut. Pour tout autre format en sortie, cet environnement n’est pas pris en charge et aucune pyramide n’est créée.

  • Pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil, reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst.

Paramètres

ÉtiquetteExplicationType de données
Données raster ou vecteur source en entrée

Emplacement des sources en entrée.

Il s’agit d’un raster ou d’une entité (ponctuelle, linéaire ou surfacique) qui identifie les cellules ou les emplacements qui seront utilisés pour calculer la distance de plus faible coût cumulé pour chaque emplacement de cellule en sortie.

Pour les rasters, le type d'entrée peut être entier ou à virgule flottante.

Raster Layer; Feature Layer
Raster d’interruption ou données d’entités en entrée
(Facultatif)

Jeu de données qui définit les interruptions.

Les interruptions peuvent être définies par un entier ou un raster à virgule flottante, ou par une entité ponctuelle, linéaire ou surfacique.

Pour une interruption de raster, l’interruption doit avoir 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)

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 Layer
Raster de coût en entrée
(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).

Raster Layer
Raster vertical en entrée
(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.

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. 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 descriptions ci-dessous, deux acronymes sont utilisés. Le facteur VF correspond au facteur vertical, lequel représente la difficulté verticale rencontrée lors d’un déplacement à partir 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 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, à la fois du côté négatif et du côté positif de l’angle VRMA, respectivement ; 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, à la fois du côté négatif et du côté positif de l’angle VRMA, respectivement ; 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.
  • Table : un fichier de table est utilisé pour définir le diagramme des facteurs verticaux qui permet de déterminer les facteurs VF.

Les modificateurs des mots-clés de facteur vertical 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) : 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).
  • Table name (Nom de la table) : nom de la table définissant le facteur VF.
Vertical Factor
Raster horizontal en entrée
(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.

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. En outre, vous pouvez utiliser une table pour créer un diagramme personnalisé. 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, deux acronymes sont utilisés. Le facteur HF correspond au facteur horizontal, qui représente la difficulté horizontale rencontrée lors d’un déplacement à partir 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 de 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.
  • Table : un fichier de table est utilisé pour définir le diagramme des facteurs horizontaux permettant de déterminer les facteurs HF.

Les modificateurs des facteurs horizontaux sont les suivants :

  • Zero factor (Facteur zéro) : 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.
  • Cut angle (Angle d’inflexion) : l’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 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é.
  • Table name (Nom de la table) : nom de la table définissant le facteur HF.
Horizontal Factor
Raster d’accumulation de distance en sortie
(Facultatif)

Le raster 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.

Raster Dataset
Raster de direction arrière en sortie
(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.

Raster Dataset
Raster de direction source en sortie
(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.

Raster Dataset
Raster d’emplacement source en sortie
(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é.

Raster Dataset
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 à appliquer aux coûts
(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 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 sourceLes 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 sourceLes 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).

  • planeLe 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ésiqueLe 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

Valeur renvoyée

ÉtiquetteExplicationType de données
Raster d’allocation de distance en sortie

Raster d’allocation de distance en sortie.

Raster

DistanceAllocation(in_source_data, {in_barrier_data}, {in_surface_raster}, {in_cost_raster}, {in_vertical_raster}, {vertical_factor}, {in_horizontal_raster}, {horizontal_factor}, {out_distance_accumulation_raster}, {out_back_direction_raster}, {out_source_direction_raster}, {out_source_location_raster}, {source_field}, {source_initial_accumulation}, {source_maximum_accumulation}, {source_cost_multiplier}, {source_direction}, {distance_method})
NomExplicationType de données
in_source_data

Emplacement des sources en entrée.

Il s’agit d’un raster ou d’une entité (ponctuelle, linéaire ou surfacique) qui identifie les cellules ou les emplacements qui seront utilisés pour calculer la distance de plus faible coût cumulé pour chaque emplacement de cellule en sortie.

Pour les rasters, le type d'entrée peut être entier ou à virgule flottante.

Raster Layer; Feature Layer
in_barrier_data
(Facultatif)

Jeu de données qui définit les interruptions.

Les interruptions peuvent être définies par un entier ou un raster à virgule flottante, ou par une entité ponctuelle, linéaire ou surfacique.

Pour une interruption de raster, l’interruption doit avoir une valeur valide, y compris zéro, et les surfaces ne constituant pas des interruptions doivent être de type NoData.

Raster Layer; Feature Layer
in_surface_raster
(Facultatif)

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 Layer
in_cost_raster
(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).

Raster Layer
in_vertical_raster
(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.

Raster Layer
vertical_factor
(Facultatif)

L’objet Vertical factor 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. 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 descriptions ci-dessous, deux acronymes sont utilisés. Le facteur VF correspond au facteur vertical, lequel représente la difficulté verticale rencontrée lors d’un déplacement à partir 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.

L'objet se présente sous les différentes formes suivantes :

Leurs définitions et paramètres sont indiqués ci-dessous :

  • 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, à la fois du côté négatif et du côté positif de l’angle VRMA, respectivement ; 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, à la fois du côté négatif et du côté positif de l’angle VRMA, respectivement : 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.

  • VfTable(inTable)

    Un fichier de table est utilisé pour définir le diagramme des facteurs verticaux qui permet de déterminer les facteurs VF.

Les modificateurs des paramètres verticaux sont les suivants :

  • zeroFactor : facteur vertical utilisé lorsque la valeur VRMA est égale à 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).
  • inTable : nom de la table définissant le facteur VF.
Vertical Factor
in_horizontal_raster
(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 induit lors d’un déplacement à partir d’une cellule vers les cellules voisines.

Raster Layer
horizontal_factor
(Facultatif)

L’objet Horizontal Factor 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. En outre, vous pouvez utiliser une table pour créer un diagramme personnalisé. 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, deux acronymes sont utilisés. Le facteur HF correspond au facteur horizontal, qui représente la difficulté horizontale rencontrée lors d’un déplacement à partir 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 de déplacement.

L'objet se présente sous les différentes formes suivantes :

Leurs définitions et paramètres sont indiqués ci-dessous :

  • 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.

  • HfTable(inTable)

    Un fichier de table est utilisé pour définir le diagramme des facteurs horizontaux permettant de déterminer les facteurs HF.

Les modificateurs des mots-clés horizontaux sont les suivants :

  • zeroFactor : facteur horizontal à utiliser lorsque 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 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 HfForward est spécifié.
  • inTable : nom de la table définissant le facteur HF.

Horizontal Factor
out_distance_accumulation_raster
(Facultatif)

Le raster 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.

Raster Dataset
out_back_direction_raster
(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.

Raster Dataset
out_source_direction_raster
(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.

Raster Dataset
out_source_location_raster
(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é.

Raster Dataset
source_field
(Facultatif)

Champ permettant d’attribuer des valeurs aux emplacements source. Il doit être de type entier.

Field
source_initial_accumulation
(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
source_maximum_accumulation
(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
source_cost_multiplier
(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
source_direction
(Facultatif)

Indique le sens de déplacement du voyageur lorsque des facteurs horizontal et vertical sont appliqués.

  • FROM_SOURCELes 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_SOURCELes facteurs horizontal et 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 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.

String; Field
distance_method
(Facultatif)

Indique si la distance est calculée avec une méthode plane (Terre plate) ou géodésique (ellipsoïde).

  • PLANARLe 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.
  • GEODESICLe 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

Valeur renvoyée

NomExplicationType de données
out_distance_allocation_raster

Raster d’allocation de distance en sortie.

Raster

Exemple de code

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

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outDistAlloc = DistanceAllocation("insources.shp", "barriers.tif")
outDistAlloc.save("c:/sapyexamples/output/distalloc.tif")
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: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inSources = "insources.shp"
inBarrier = "barriers.tif"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute EucDirections
outDistAlloc = DistanceAllocation(inSources, inBarrier)

# Save the output 
outDistAlloc.save("c:/sapyexamples/output/distAllo2.tif")

Informations de licence

  • Basic: Nécessite Spatial Analyst
  • Standard: Nécessite Spatial Analyst
  • Advanced: Nécessite Spatial Analyst

Rubriques connexes