Générer une couche voxel multidimensionnelle (Outils multidimensionnels)

Synthèse

Crée une couche voxel à partir d'un jeu de données voxel multidimensionnel. Les jeux de données voxel comportant une source netCDF sont les seules entrées prises en charge.

Utilisation

Paramètres

ÉtiquetteExplicationType de données
Jeu de données NetCDF en entrée

Jeu de données voxel en entrée. Les jeux de données voxel pris en charge comprennent les fichiers netCDF.

File
Couche voxel en sortie

Couche voxel en sortie.

Voxel Layer
Variables
(Facultatif)

Spécifie les noms des variables qui seront générées en sortie dans la couche voxel et indique si ces variables sont des variables discrètes ou continues. Si aucune variable n'est spécifiée, toutes les variables issues du jeu de données voxel seront utilisées avec les types de données en fonction du type spécifié dans le jeu de données voxel. Par exemple, une valeur d'entier sera considérée comme une variable discrète et une valeur de type double comme une variable continue. Décochez la valeur de colonne Utilisation pour supprimer la variable de la couche en sortie.

Les types de données disponibles sont les suivants :

  • Continu : à utiliser pour les valeurs à virgule flottante.
  • Discret : à utiliser pour les valeurs sans virgule flottante.
Value Table
Alignement de la position du voxel
(Facultatif)

Indique si la valeur de voxel représentera les valeurs au centre ou à l'origine d'un cube de voxel.

  • CentreLa valeur de voxel représentera le centre du cube de voxel. Il s'agit de l'option par défaut.
  • OrigineLa valeur de voxel représentera l'origine du cube de voxel.
String
Mode d'exagération
(Facultatif)

Spécifie le mode d'exagération qui sera utilisé pour la couche de voxel.

  • À partir de l'origine du jeu de données voxelSeuls les voxels seront mis à l'échelle. Il s'agit de l'option par défaut.
  • Coordonnées zToutes les positions z seront multipliées par la valeur d'exagération. Utilisez cette option lors de l'exagération d'autres données 3D avec la couche voxel.
String
Exagération
(Facultatif)

Exagération verticale de la couche voxel. La valeur par défaut est proportionnelle à l'étendue x,y de la couche.

Double
Décalage
(Facultatif)

Décalage qui sera utilisé pour élever ou abaisser la couche voxel dans la dimension z.

Double
Optimiser les performances
(Facultatif)

Indique si un fichier .vxc1 sera créé pour améliorer les performances d'affichage de la couche voxel. Le fichier sera créé dans le même dossier que le fichier netCDF.

  • Activé : un fichier .vxc1 sera créé. Il s'agit de l'option par défaut.
  • Désactivé : aucun fichier .vxc1 ne sera créé.
Boolean

arcpy.management.MakeMultidimensionalVoxelLayer(in_dataset, out_layer, {variables}, {voxel_position}, {exaggeration_mode}, {exaggeration}, {offset}, {optimize_performance})
NomExplicationType de données
in_dataset

Jeu de données voxel en entrée. Les jeux de données voxel pris en charge comprennent les fichiers netCDF.

File
out_layer

Couche voxel en sortie.

Voxel Layer
variables
[variables,...]
(Facultatif)

Spécifie les noms des variables qui seront générées en sortie dans la couche voxel et indique si ces variables sont des variables discrètes ou continues. Si aucune variable n'est spécifiée, toutes les variables issues du jeu de données voxel seront utilisées avec les types de données en fonction du type spécifié dans le jeu de données voxel. Par exemple, une valeur d'entier sera considérée comme une variable discrète et une valeur de type double comme une variable continue. Décochez la valeur de colonne Utilisation pour supprimer la variable de la couche en sortie.

Les types de données disponibles sont les suivants :

  • CONTINUOUS : à utiliser pour les valeurs à virgule flottante.
  • DISCRETE : à utiliser pour les valeurs sans virgule flottante.
Value Table
voxel_position
(Facultatif)

Indique si la valeur de voxel représentera les valeurs au centre ou à l'origine d'un cube de voxel.

  • CENTERLa valeur de voxel représentera le centre du cube de voxel. Il s'agit de l'option par défaut.
  • ORIGINLa valeur de voxel représentera l'origine du cube de voxel.
String
exaggeration_mode
(Facultatif)

Spécifie le mode d'exagération qui sera utilisé pour la couche de voxel.

  • FROM_VOXEL_DATASET_ORIGINSeuls les voxels seront mis à l'échelle. Il s'agit de l'option par défaut.
  • Z-COORDINATESToutes les positions z seront multipliées par la valeur d'exagération. Utilisez cette option lors de l'exagération d'autres données 3D avec la couche voxel.
String
exaggeration
(Facultatif)

Exagération verticale de la couche voxel. La valeur par défaut est proportionnelle à l'étendue x,y de la couche.

Double
offset
(Facultatif)

Décalage qui sera utilisé pour élever ou abaisser la couche voxel dans la dimension z.

Double
optimize_performance
(Facultatif)

Indique si un fichier .vxc1 sera créé pour améliorer les performances d'affichage de la couche voxel. Le fichier sera créé dans le même dossier que le fichier netCDF.

  • OPTIMIZEDUn fichier .vxc1 est créé. Il s'agit de l'option par défaut.
  • NOT_OPTIMIZEDAucun fichier .vxc1 ne sera créé.
Boolean

Exemple de code

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

Le script Python suivant crée une couche voxel avec une exagération et un décalage spécifiés par l'utilisateur.

import arcpy
arcpy.md.MakeMultidimensionalVoxelLayer(
    in_dataset="emu_small_subset.nc",
    out_layer="emu_small_subset_Layer",
    variables=[[False, "ocean_name", "DISCRETE"], [True, "salinity", "CONTINUOUS"], [True, "temp", "CONTINUOUS"]],
    voxel_position="CENTER",
    exaggeration_mode="FROM_VOXEL_DATASET_ORIGIN",
    exaggeration=5000.00,
    offset=200.00,
    optimize_performance="OPTIMIZED"
)
Exemple 2 d'utilisation de l'outil MakeMultidimensionalVoxelLayer (script autonome)

Le script Python suivant crée un paquetage de couche de scènes voxel et publie ce paquetage en tant que couche de scènes Web dans ArcGIS Online.

import arcpy

# Create the voxel layer
arcpy.md.MakeMultidimensionalVoxelLayer(
    in_dataset=r"C:\data\emu_small_subset.nc",
    out_layer="emu_small_subset_Layer",
    variables=[[False, "ocean_name", "DISCRETE"], [True, "salinity", "CONTINUOUS"], [True, "temp", "CONTINUOUS"]],
    voxel_position="CENTER",
    exaggeration_mode="FROM_VOXEL_DATASET_ORIGIN",
    exaggeration=None,
    offset=None,
    optimize_performance="OPTIMIZED"
)

# Create the voxel scene layer package
arcpy.management.CreateVoxelSceneLayerContent(
    in_dataset="emu_small_subset_Layer",
    out_slpk=r"C:\data\emu_voxel.slpk"
)

# Share the slpk and publish as web scene layer
arcpy.management.SharePackage(
    in_package=r"C:\data\emu_voxel.slpk",
    username="",
    password=None,
    summary="",
    tags="",
    credits="",
    public="MYGROUPS",
    groups=None,
    organization="MYORGANIZATION",
    publish_web_layer="TRUE",
    portal_folder=""
)

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.