Entités vers NetCDF (Outils multidimensionnels)

Résumé

Convertit des entités ponctuelles en fichier netCDF.

Utilisation

Le nom de variable par défaut est identique au nom de champ d’entité en entrée spécifié dans le paramètre Fields to Variables (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 Fields to Variables (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 Fields to Variables (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 Fields to Dimensions (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 Fields to Dimensions (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.

Etiqueter	Explication	Type de données
Input Features (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. Colonnes de la table de valeurs : Field—A field in the input feature attribute table. Variable—The netCDF variable name. Units—The units of the data represented by the field.	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. Colonnes de la table de valeurs : Field—A field in the input feature attribute table. Dimension—The netCDF dimension name. Units—The units of the data represented by the field.	Value Table

arcpy.md.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. Colonnes de la table de valeurs : `Field`—A field in the input feature attribute table. `Variable`—The netCDF variable name. `Units`—The units of the data represented by the field.	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. Colonnes de la table de valeurs : `Field`—A field in the input feature attribute table. `Dimension`—The netCDF dimension name. `Units`—The units of the data represented by the field.	Value Table

Exemple de code

Exemple 1 de FeatureToNetCDF (fenêtre Python)

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

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

Exemple 2 de FeatureToNetCDF (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"

# Run FeatureToNetCDF
arcpy.md.FeatureToNetCDF(inFeatures, fieldToVariable, outNetCDFFile,
                         fieldToDimension)

Environnements

Espace de travail courant, Espace de travail temporaire

Informations de licence