<< nccreate sciNetCDF ncread >>

sciNetCDF >> sciNetCDF > ncwrite

ncwrite

Ecrit une variable dans un fichier NetCDF.

Séquence d'appel

ncwrite(filename, varname, vardata, [start, [stride]])

Paramètres

filename

Chemin d'accès complet vers un fichier NetCDF (string).

varname

Nom d'une variable (string).

vardata

Données à écrire (scalaire, matrice, hypermatrice de double/entier, ou chaîne de caractères).

start

Optionnel, indices auxquels les données sont écrites dans chaque dimension (vecteur de double, les indices commencent à 1).

stride

Optionnel, espaces inter-élément dans chaque dimension (vecteur de double).

Description

ncwrite écrit les données vardata de la variable varname dans le fichier NetCDF filename.

La variable et le fichier doivent être créés au préalable (grâce à la fonction nccreate() ou tout autre moyen). L'emplacement de la variable (i.e. le chemin du groupe dans lequel la variable est stockée) est spécifié dans varname en utilisant la forme /grp/subgrp/.../varname.

vardata peut être un scalaire, une matrice ou une hypermatrice du type de la variable (une conversion, si possible, aura lieu si le type diffère). Les variables avec une dimension illimitée seront étendues si nécessaire.

Dans le cas de variable de type double/float, les valeurs manquantes ou égales à %nan sont automatiquement remplacées par la valeur de remplacement durant l'écriture. La valeur de remplacement est soit donnée en argument optionnel de la fonction nccreate ou par défaut la valeur définie par NetCDF.

Les paramètres optionnels start and stride spécifient les indices auxquel les données sont écrites. Si des données existent déjà à ces indices, elles sont écrasées.

Exemples

filename = fullfile(TMPDIR, 'vars.nc');

// Ecrit le double 'x' 3.2
nccreate(filename, 'x');
ncwrite(filename, 'x', 3.2);

// Ecrit la variable 'n' 100 (scalaire int8)
nccreate(filename, 'n', 'Datatype', 'int8');
ncwrite(filename, 'n', 100);

// Ecrit la variable 'y' 1.0 dans le groupe 'grp'
nccreate(filename, 'grp/y');
ncwrite(filename, 'grp/y', 1.0);

// Ecrit la chaîne de caractères  'Hello' dans la variable 'str'
nccreate(filename, 'str', 'Datatype', 'char', 'Dimensions', list('len', 10));
ncwrite(filename, 'str', 'Hello');

// Ecrit les données du vecteur d'entiers 'vec'
nccreate(filename, 'vec', 'Datatype', 'int32', 'Dimensions', list('dim', %inf));
ncwrite(filename, 'vec',  [1 2 4 8 16]);

// Ecrit les données de la matrice de double 'mat' de dimensions (3, 4)
nccreate(filename, 'mat', 'Dimensions', list('r', 3, 'c', 4));
ncwrite(filename, 'mat',  [1 2 3 4; 5 6 7 8; 9 10 11 12]);

ncdisp(filename);

Voir aussi


Report an issue
<< nccreate sciNetCDF ncread >>