Entités vers NetCDF (Multidimension)

Résumé

Convertit une classe d'entités points 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.

  • 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 des 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 Champs vers dimensions.

  • 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, un identifiant RecordID de dimension est créé dans le fichier netCDF en sortie avec une taille é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.

  • L’outil écrit les variables au format DSG (Discrete Sample Geometry), par exemple des points ou une trajectoire, conformément aux conventions CFLien vers le site Web des 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.

Syntaxe

arcpy.md.FeatureToNetCDF(in_features, fields_to_variables, out_netCDF_file, {fields_to_dimensions})
ParamètreExplicationType de données
in_features

Classe d'entités points 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 porter l’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)

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes