<< ncread sciNetCDF ncreadatt >>

sciNetCDF >> sciNetCDF > ncwriteatt

ncwriteatt

Ecrit un attribut dans un fichier NetCDF.

Séquence d'appel

ncwriteatt(filename, location, attname, attvalue)

Paramètres

filename

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

attname

Nom de l'attribut (string).

location

Chemin du groupe et/ou de la variable contenant l'attribut (string). La forme complète est /grp/subgrp/.../varname. Le chemin d'un attribut de groupe doit finir par '/'. Pour un attribut global, utiliser '/'.

attvalue

Valeur de l'attribut (vecteur de double/entier ou une chaîne de caractères).

Description

ncwriteatt écrit l'attribut spécifié par attname à l'emplacement spécifié par location dans le fichier NetCDF filename.

L'emplacement location est un chemin complet vers un attribut de variable, de groupe ou un attribut global. Les groupes qui n'existent pas seront créés. Si l'attribut appartient à une variable celle-ci doit être créée préalablement (grâce à la fonction nccreate ou tout autre moyen).

La valeur attvalue peut être un scalaire, ou un vecteur de double/entier ou encore une chaîne de caractères. Si l'attribut existe déjà, sa valeur est écrasée.

Si le fichier n'existe pas il est créé (dans le format NetCDF4 étendu), sinon il est repris en écriture (pas d'écrasement).

Exemples

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

// Ecrit les attributs globaux 'version' et 'date'
ncwriteatt(filename, '/', 'version', int32(1));
ncwriteatt(filename, '/', 'date', now());

// Ecrit la variable 'grp/precip'
nccreate(filename, '/grp/precip', 'Dimensions', list('t', 5));
ncwrite(filename, '/grp/precip', [5.0 8.5 9.5 11.0 7.3]);

// Ecrit les attributs 't' et 'unit' de la variable ('grp/precip')
ncwriteatt(filename, '/grp/precip', 't', [0.0 10.0 20.0 30.0 40.0]);
ncwriteatt(filename, '/grp/precip', 'unit', 'mm');

// Ecrit l'attribut 'name' du groupe 'grp'
ncwriteatt(filename, 'grp/', 'name', 'some_city');

ncdisp(filename);

Voir aussi


Report an issue
<< ncread sciNetCDF ncreadatt >>