propriété dataFileAttributes ( Python )

La propriété dataFileAttributes d'un objet Dataset permet d'obtenir ou de définir des attributs de fichier pour le jeu de données. La propriété dataFileAttributes se comporte comme un dictionnaire Python en termes d'obtention, de définition et de suppression de valeurs. Un dictionnaire Python se compose d'un ensemble de clés, dont chacune est associée à une valeur accessible simplement en spécifiant la clé. Dans le cas des attributs de fichier de données, chaque clé est le nom d'un attribut et la valeur associée est la valeur de l'attribut, qui peut être une valeur unique ou une liste ou un tuple de valeurs. Une liste ou un tuple de valeurs spécifie un tableau d'attributs.

• Lors de la définition des attributs, les noms et les valeurs d'attribut doivent être indiqués sous forme de chaînes entre guillemets.

Extraction des attributs de fichier de données. Vous extrayez les attributs de fichier de données d'un jeu de données à partir de la propriété dataFileAttributes de l'objet Dataset associé. Vous pouvez extraire la valeur d'un attribut particulier en spécifiant le nom de l'attribut, comme dans:

dsObj = spss.Dataset()
attr = dsObj.dataFileAttributes['attrName']

Les valeurs d'attribut sont toujours renvoyées en tant que tuple.

Vous pouvez effectuer une itération dans l'ensemble des attributs de fichier de données à l'aide de la propriété data , comme dans:

dsObj = spss.Dataset()
for attrName, attrValue in dsObj.dataFileAttributes.data.iteritems():
   print attrName, attrValue

Ajout et modification des attributs de fichier de données. Vous pouvez ajouter de nouveaux attributs de fichier de données et modifier des attributs existants. Par exemple :

dsObj.dataFileAttributes['attrName'] = 'value'

• Si l'attribut attrName existe, il est mis à jour avec la valeur spécifiée. Si l'attribut attrName n'existe pas, il est ajouté à tous les attributs existants du jeu de données.

Réinitialisation des attributs de fichier de données. Vous pouvez réinitialiser les attributs de fichier de données associés à un jeu de données. Par exemple :

dsObj.dataFileAttributes = {'attr1':'value','attr2':['val1','val2']}

• Vous réinitialisez les attributs du fichier de données en attribuant à la propriété dataFileAttributes un nouveau dictionnaire Python. Tous les attributs de fichier de données existants sont effacés et remplacés par les attributs spécifiés.

Suppression des attributs de fichier de données. Vous pouvez supprimer un attribut de fichier de données particulier ou tous les attributs. Par exemple :

#Delete a specified attribute
del dsObj.dataFileAttributes['attrName']
#Delete all attributes
del dsObj.dataFileAttributes