Créer une couche voxel multidimensionnelle (Outils multidimensionnels)

Résumé

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

Sauf indication contraire, toutes les variables prises en charge dans le fichier netCDF seront incluses dans la sortie.
Sauf indication contraire, les valeurs par défaut de l'exagération et du décalage seront calculées dans la sortie.
Cet outil respecte la symbologie définie par les outils Nearest Neighbor 3D (Voisin le plus proche 3D) et Empirical Bayesian Kriging 3D (Krigeage bayésien empirique 3D). Vous pouvez également ajouter un attribut si vous créez un fichier NetCDF à l’aide d’autres processus pour conserver une symbologie spécifique. Un dégradé de couleurs par défaut est utilisé en l’absence de spécification.
Cet outil génère une couche temporaire qui n’est conservée que si vous l’avez enregistrée en tant que fichier de couche.
Pour partager la couche voxel dans ArcGIS Enterprise ou ArcGIS Online, utilisez les outils Create Voxel Scene Layer Content (Créer le contenu d'une couche de scène voxel) et Share Package (Partager un paquetage).

Etiqueter	Explication	Type 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 Use (Utilisation) pour supprimer la variable de la couche en sortie. Colonnes de la table de valeurs : Use—Specifies whether to remove the variable from the output layer. Name—The names of the variables. Data Type—Specifies whether the variables are discrete or continuous. Discrete—The variable is discrete. Use for nonfloating point values. Continuous—The variable is continuous. Use for floating-point values.	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. Centre—La valeur de voxel représentera le centre du cube de voxel. Il s’agit de l’option par défaut. Origine—La 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 voxel—Seuls les voxels seront mis à l'échelle. Il s’agit de l’option par défaut. Coordonnées z—Toutes 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` est créé. Il s’agit de l’option par défaut. Décoché—Aucun fichier `.vxc1` ne sera créé.	Boolean

arcpy.md.MakeMultidimensionalVoxelLayer(in_dataset, out_layer, {variables}, {voxel_position}, {exaggeration_mode}, {exaggeration}, {offset}, {optimize_performance})

Nom	Explication	Type 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 Use (Utilisation) pour supprimer la variable de la couche en sortie. Colonnes de la table de valeurs : `Use`—Specifies whether to remove the variable from the output layer. `Name`—The names of the variables. `Data Type`—Specifies whether the variables are discrete or continuous. `DISCRETE`—The variable is discrete. Use for nonfloating point values. `CONTINUOUS`—The variable is continuous. Use for floating-point values.	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. `CENTER`—La valeur de voxel représentera le centre du cube de voxel. Il s’agit de l’option par défaut. `ORIGIN`—La 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_ORIGIN`—Seuls les voxels seront mis à l'échelle. Il s’agit de l’option par défaut. `Z-COORDINATES`—Toutes 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. `OPTIMIZED`—Un fichier `.vxc1` est créé. Il s’agit de l’option par défaut. `NOT_OPTIMIZED`—Aucun fichier `.vxc1` ne sera créé.	Boolean

Exemple de code

Exemple 1 de 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 de 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.

Informations de licence