Entités vers NetCDF (Outils multidimensionnels)

Synthèse

Convertit des entités ponctuelles en fichier netCDF.

Utilisation

• Le nom de variable par défaut est identique au nom du champ d’entité en entrée spécifié dans le paramètre Champs vers variables (fields_to_variables dans Python).

• Le type de variable est identique au type de champ.

• Les champs spéciaux Shape.X et Shape.Y sont toujours disponibles dans la liste déroulante Champs vers variables. Ils permettent de spécifier des noms de variable respectivement pour les coordonnées x et les coordonnées y. Si les noms de variable ne sont pas spécifiés ou si Shape.X et Shape.Y ne sont pas ajoutés à la liste, les coordonnées x et y sont exportées avec des noms de variable par défaut. Les noms de variable par défaut respectifs pour Shape.X et Shape.Y sont lon et lat lorsque l'entité est dans un système de coordonnées géographiques. Dans tous les autres cas, les noms de variable par défaut respectifs pour Shape.X et Shape.Y sont x et y

• Les champs spéciaux Shape.Z et Shape.M sont disponibles dans la liste déroulante Champs vers variables pour les entités comportant des valeurs Z et M. Pour exporter des valeurs Z et M, vous devez ajouter Shape.Z et Shape.M à la liste. Les noms de Variable par défaut respectifs pour Shape.Z et Shape.M sont z et m.

• Le nom de dimension par défaut est identique au nom du champ d’entité en entrée spécifié dans le paramètre Champs vers dimensions (fields_to_ dimensions dans Python).

• La taille d'une dimension est égale au nombre de valeurs uniques dans le champ respectif.

• Si aucun champ n’est spécifié en tant que dimension de lignes, une valeur RecordID de dimension est créée dans le fichier netCDF en sortie dont la taille est égale au nombre d’entités.

• Les champs de type chaîne ne peuvent pas être utilisés pour créer des dimensions dans le fichier netCDF.

• Lorsque plusieurs champs sont utilisés pour créer des dimensions dans le fichier netCDF à l’aide du paramètre Champs vers dimensions, le fichier netCDF en sortie peut atteindre une taille importante. Vérifiez que l’espace de l’emplacement en sortie est suffisant pour éviter un échec de l’outil.

• L’outil écrit les variables au format DSG (Discrete Sample Geometry), par exemple des points ou une trajectoire, conformément aux conventions CF. Ces données n’étant pas carroyées, les variables du fichier netCDF en sortie ne permettent pas la création d’une couche voxel.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Entités en entrée	Entités ponctuelles en entrée.	Feature Layer
Champs vers variables	Champ(s) utilisé(s) pour créer des variables dans le fichier netCDF. Quatre champs spéciaux, Shape.X, Shape.Y, Shape.Z et Shape.M, peuvent être utilisés respectivement pour l’exportation de coordonnées X ou longitude, de coordonnées Y ou latitude, de valeurs Z et de valeurs M des entités en entrée. Champ : champ dans la table attributaire d'entités en entrée. Variable : nom de la variable netCDF. Units (Unités) : unités des données représentées par le champ.	Value Table
Fichier NetCDF en sortie	Fichier netCDF en sortie. Le nom de fichier doit avoir une extension .nc.	File
Champs vers dimensions (Facultatif)	Champ(s) utilisé(s) pour créer des dimensions dans le fichier netCDF. Champ : champ dans la table attributaire d'entités en entrée. Dimension : nom de la dimension netCDF. Units (Unités) : unités des données représentées par le champ.	Value Table

Python

arcpy.management.FeatureToNetCDF(in_features, fields_to_variables, out_netCDF_file, {fields_to_dimensions})

Nom	Explication	Type de données
in_features	Entités ponctuelles en entrée.	Feature Layer
fields_to_variables [[field, {variable}, {units}],...]	Champ(s) utilisé(s) pour créer des variables dans le fichier netCDF. Quatre champs spéciaux, Shape.X, Shape.Y, Shape.Z et Shape.M, peuvent être utilisés respectivement pour l’exportation de coordonnées X ou longitude, de coordonnées Y ou latitude, de valeurs Z et de valeurs M des entités en entrée. field : champ dans la table attributaire d’entités en entrée. {variable} : nom de la variable netCDF. {units} : unités des données représentées par le champ.	Value Table
out_netCDF_file	Fichier netCDF en sortie. Le nom de fichier doit avoir une extension .nc.	File
fields_to_dimensions [[field, {dimension}, {units}],...] (Facultatif)	Champ(s) utilisé(s) pour créer des dimensions dans le fichier netCDF. field : champ dans la table attributaire d’entités en entrée. {dimension} : nom de la dimension netCDF. {units} : unités des données représentées par le champ.	Value Table

Exemple de code

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

Convertit une classe d'entités en fichier netCDF.

import arcpy
arcpy.FeatureToNetCDF_md("c:/data/spotelev.shp", [["Shape.X", "lon"],
                         "degree_east", ["Shape.Y", "lat", "degree_north"],
                         ["elevation", "elevation", "meter"]],
                         "c:/output/pointelev01.nc", "id")

Exemple d'utilisation de l'outil FeatureToNetCDF 2 (script autonome)

Convertit une classe d'entités en fichier netCDF.

# FeatureToNetCDF_Ex_02.py
# Description: Converts a feature class to a netCDF file.
# Requirements: None

# Import system modules
import arcpy
from arcpy import env

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

# Set local variables
inFeatures = "spotelev.shp"
fieldToVariable = [["Shape.Y", "lat", "degree_north"],
                   ["elevation", "elevation", "meter"]]
outNetCDFFile = "c:/output/pointelev02.nc"
fieldToDimension = "id"

# Execute FeatureToNetCDF
arcpy.FeatureToNetCDF_md(inFeatures, fieldToVariable, outNetCDFFile, 
                         fieldToDimension)

Environnements

Espace de travail courant, Espace de travail temporaire