Définit les propriétés du fichier .tdms, du groupe de voies ou de la voie spécifié. Si vous câblez les entrées nom du groupe et nom de la voie à des valeurs, la fonction écrit les propriétés au niveau de la voie. Si vous ne câblez que l'entrée nom du groupe à une valeur, les propriétés sont écrites au niveau du groupe. Si les entrées nom du groupe ou nom de la voie ne contiennent aucune valeur, les propriétés sont spécifiques au fichier. Si vous câblez une valeur à l'entrée nom de la voie, vous devez aussi câbler une valeur à l'entrée nom du groupe. Vous devez fermer la référence au fichier .tdms ou écrire toutes les données dans le fichier .tdms pour que les modifications soient appliquées.


icon

Entrées/Sorties

  • c1dfxdt.png valeurs des propriétés —

    valeurs des propriétés spécifie les valeurs des propriétés du groupe de voie, de la voie ou du fichier .tdms spécifié. Cette entrée accepte les types de données suivants :

    • Entiers signés ou non signés
    • Nombres à virgule flottante, y compris les types de données suivants :
      • Nombres à virgule flottante simple précision et double précision
      • Nombres à virgule flottante simple précision et double précision complexes
      • (Windows) Nombres à virgule flottante, précision étendue
    • Horodatages
    • Booléens
    • Chaînes alphanumériques qui ne contiennent aucun caractère nul
    • Variants qui contiennent n'importe quel type de données mentionné ci-dessus

    Si vous voulez définir plusieurs propriétés en utilisant la même fonction, vous pouvez câbler un tableau 1D de n'importe quel type de données spécifié plus haut à l'entrée valeurs des propriétés. Chaque valeur du tableau correspond à une propriété. Cependant, une propriété particulière ne peut pas contenir un tableau de valeurs.

  • c1dstr.png noms des propriétés —

    noms des propriétés spécifie les noms des propriétés du groupe de voie, de la voie ou du fichier .tdms spécifié.

  • cgnrn.png fichier tdms —

    tdms file spécifie un numéro de référence pour le fichier .tdms sur lequel l'opération doit être effectuée. Utilisez la fonction TDMS - Ouvrir un fichier pour ouvrir le refnum.

  • cstr.png nom du groupe —

    nom du groupe spécifie le groupe de voies sur lequel l'opération doit être effectuée. Si vous câblez une valeur à l'entrée nom de la voie, vous devez aussi câbler une valeur à cette entrée.

  • cstr.png nom de la voie —

    nom de la voie indique la voie sur laquelle l'opération doit être effectuée. Si vous câblez une valeur à cette entrée, vous devez aussi câbler une valeur à l'entrée nom du groupe.

  • cerrcodeclst.png entrée d'erreur (pas d'erreur) —

    entrée d'erreur décrit les conditions d'erreur qui ont lieu avant l'exécution de ce nœud. Cette entrée fournit la fonctionnalité entrée d'erreur standard.

  • ignrn.png fichier tdms en sortie —

    tdms file out renvoie une référence de fichierTDMS au fichier .tdms sur lequel vous avez effectué l'opération.

  • istr.png nom du groupe en sortie —

    nom du groupe en sortie renvoie le nom du groupe sur lequel l'opération a été effectuée.

  • istr.png nom de la voie en sortie —

    nom de la voie en sortie renvoie le nom de la voie sur laquelle vous avez effectué l'opération.

  • ierrcodeclst.png sortie d'erreur —

    sortie d'erreur contient des informations sur l'erreur. Cette sortie fournit la fonctionnalité sortie d'erreur standard.

    • Cette section répertorie toutes les propriétés que vous pourriez rencontrer lorsque vous utilisez un fichier .tdms. Le premier tableau répertorie toutes les propriétés que vous pourriez rencontrer dans un fichier .tdms. Le deuxième tableau répertorie toutes les propriétés qui n'existent pas dans un fichier .tdms mais que vous pouvez utiliser pour effectuer certaines actions. Vous pouvez écrire ces propriétés sous forme d'attributs de waveform dans un fichier .tdms. Cependant, certaines de ces propriétés risquent de ne pas apparaître sous forme d'attributs de waveform lorsque vous lisez les données waveform du fichier .tdms. La colonne Disponible sous forme d'attribut de waveform ? indique si une propriété est disponible sous forme d'attribut de waveform. Si le type de données d'une propriété n'est pas valide, LabVIEW traite la propriété comme une propriété personnalisée et elle ne fonctionnera pas de la façon décrite dans le tableau.

    Vous pouvez utiliser la fonction TDMS - Obtenir des propriétés pour obtenir les valeurs de ces propriétés. Utilisez la fonction TDMS - Définir des propriétés pour changer les valeurs de ces propriétés.

    Le tableau suivant répertorie toutes les propriétés que vous pourriez rencontrer dans un fichier .tdms.

    Nom de propriété Type de données Accès Disponible dans les versions de format de fichier Disponible sous forme d'attribut de waveform ? Description
    name Chaîne Lecture/Écriture 2.0 Oui Indique le nom d'un objet, comme le nom de racine, le nom de groupe ou le nom de voie, d'un fichier .tdms.
    NI_ArrayColumn Nombre entier signé 32 bits Lecture seule 1.0 et 2.0 Non Indique l'indice d'une colonne d'un tableau 2D. Cette propriété n'apparaît dans un fichier .tdms que si vous écrivez un tableau 2D de données dans le fichier.
    NI_ChannelLength Nombre entier non signé 64 bits Lecture seule 1.0 et 2.0 Oui Représente le nombre de valeurs dans une voie d'un fichier .tdms.
    NI_DataType Nombre entier non signé 16 bits Lecture seule 1.0 et 2.0 Oui

    Renvoie le type de données d'une voie. La valeur est un entier qui correspond à un code de type LabVIEW.

    Remarque Un fichier .tdms utilise un code de type différent de celui de LabVIEW pour les types de données suivants :
    • Chaîne : 0x20
    • Booléen : 0x21
    • Horodatage : 0x44
    • Nombres à virgule fixe : 0x4F
    • Nombre flottant simple précision avec unités : 0x19
    • Nombre flottant simple précision complexe : 0x08000c
    • Nombre flottant double précision complexe : 0x10000d
    • Données brutes DAQmx : 0xFFFFFFFF

    Pour obtenir la liste complète des codes de type de données du SGDT, consultez la section Valeurs des types de données dans la structure interne du format de fichier du SGDT.

    NI_DigitalCompression Booléens Lecture seule 1.0 et 2.0 Non Indique si une table numérique est compressée ou non. La valeur 1 indique que la table numérique est compressée. Si la table numérique n'est pas compressée, cette propriété n'apparaît pas.
    NI_DigitalLine Nombre entier 32 bits signé Lecture seule 1.0 et 2.0 Non Indique l'indice d'une ligne d'une table numérique.
    NI_DigitalNumberOfLines Nombre entier 32 bits signé Lecture seule 1.0 et 2.0 Non Indique le nombre de lignes d'une table numérique.
    NI_Number_Of_Scales Nombre entier 32 bits non signé Lecture/Écriture 2.0 Non Spécifie le nombre d'échelles à utiliser pour lire les données d'un fichier .tdms. Par exemple, si un fichier .tdms a cinq échelles et que vous définissez la valeur de NI_Number_Of_Scales à 4, LabVIEW n'applique que les quatre premières échelles aux données lorsque vous lisez le fichier .tdms.
    NI_Scale[n]_config, où n représente l'ordre de la balance et config représente la configuration de la balance. N/A Lecture/Écriture 2.0 Non Spécifie les informations de mise à l'échelle pour les données d'un fichier .tdms. Vous pouvez créer plusieurs échelles dans un fichier .tdms.
    Remarque National Instruments recommande d'utiliser le VI TDMS Create Scaling Information pour créer des échelles.
    NI_Scaling_Status Chaîne Lecture/Écriture 2.0 Non Spécifie si LabVIEW met les données à l'échelle lorsqu'il lit les données d'un fichier .tdms. Si la valeur est unscaled et que le fichier .tdms contient une ou plusieurs échelles, LabVIEW met les données à l'échelle. Si la valeur est scaled, LabVIEW ne met pas les données à l'échelle. Pour les voies de données DAQmx, LabVIEW ne peut pas renvoyer de données non mises à l'échelle même lorsque NI_Scaling_Status est unscaled.
    unit_string Chaîne Lecture/Écriture 1.0 et 2.0 Non Spécifie l'unité des données de voie dans un fichier .tdms.
    wf_increment Double précision Lecture/Écriture 1.0 et 2.0 Non Représente l'incrément entre deux échantillons consécutifs sur l'axe des x.
    wf_samples Nombre entier 32 bits signé Lecture/Écriture 1.0 et 2.0 Non Représente le nombre d'échantillons dans le premier bloc de données de la waveform que vous écrivez dans un fichier .tdms. La valeur doit être supérieure à zéro.
    wf_start_offset Double précision Lecture seule 1.0 et 2.0 Non Les données fréquence-domaine et les résultats d'histogrammes utilisent cette valeur comme première valeur sur l'axe des x.
    wf_start_time Horodatage Lecture seule 1.0 et 2.0 Non Représente le temps auquel la waveform a été acquise ou générée. Cette propriété peut être 0 si les informations temporelles sont relatives ou si la waveform n'appartient pas au domaine termporel.
    wf_time_pref Chaîne Lecture seule 1.0 et 2.0 Non Indique si LabVIEW interprète les données de l'axe des x en temps absolu ou relatif.
    wf_xname Chaîne Lecture seule 1.0 et 2.0 Non Indique le nom de l'axe des x de la waveform.
    wf_xunit_string Chaîne Lecture seule 1.0 et 2.0 Non Indique le texte d'unité de l'axe des x.

    En plus des propriétés du tableau précédent, un fichier .tdms peut contenir d'autres attributs de waveform.

    Le tableau suivant répertorie toutes les propriétés qui n'existent pas dans un fichier .tdms mais que vous pouvez utiliser pour effectuer certaines actions.

    Nom de propriété Type de données Unité Accès Disponible dans les versions de format de fichier Disponible sous forme d'attribut de waveform ? Description
    NI_DiskCacheSize Nombre entier 32 bits non signé Octet Lecture/Écriture 2.0 Oui Vous pouvez utiliser la propriété NI_DiskCacheSize pour améliorer les performances d'écriture de données .tdms en allouant une taille de cache mémoire spécifique pour les données. LabVIEW écrit les données .tdms en octets par fichier. Cette propriété n'est valide que si l'entrée désactiver la bufférisation ? de la fonction TDMS - Ouvrir est VRAI. La valeur par défaut de cette propriété est environ 2 Mo. Câblez une valeur différente à l'entrée valeurs des propriétés de la fonction TDMS - Définir des propriétés pour changer la taille du cache. En général, une valeur plus grande pour la propriété NI_DiskCacheSize améliore les performances d'écriture, mais utilise aussi davantage de ressources système.
    NI_DiskGapSize Nombre entier 32 bits non signé Octet Lecture/Écriture 2.0 Oui Vous pouvez utiliser la propriété NI_DiskGapSize pour améliorer les performances de lecture de données .tdms lors d'une lecture de données discontinues. Cette propriété n'est valide que si l'entrée désactiver la bufférisation ? de la fonction TDMS - Ouvrir est VRAI. La valeur de la propriété NI_DiskGapSize est un multiple de la taille de secteur du disque dur local. La valeur par défaut de cette propriété est 10. Si l'intervalle entre les données du fichier .tdms est inférieur à la valeur de la propriété NI_DiskGapSize, la fonction TDMS - Lire peut lire toutes les données du fichier en une fois. Si l'intervalle entre les données du fichier .tdms est supérieur à la valeur de la propriété NI_DiskGapSize, la fonction TDMS - Lire lit un élément de donnée à la fois jusqu'à ce que cette fonction finisse de lire toutes les données. Câblez une valeur à l'entrée valeurs des propriétés de la fonction TDMS - Définir des propriétés pour changer la taille de l'intervalle.
    Remarque Il faut faire des essais pour obtenir les performances de lecture et d'écriture optimales. La même configuration risque de ne pas produire les mêmes performances optimales sur des ordinateurs différents. Vous devrez peut-être ajuster les valeurs des propriétés après avoir déployé une application d'un ordinateur sur un autre.
    NI_InMemoryFileSize Nombre entier signé 64 bits Octet Lecture seule 2.0 Oui Vous pouvez utiliser la propriété NI_InMemoryFileSize pour renvoyer la taille du fichier .tdms en mémoire.
    NI_InMemoryWriteBlockSize Nombre entier signé 64 bits Octet Lecture/Écriture 2.0 Oui Vous pouvez utiliser la propriété NI_InMemoryWriteBlockSize pour allouer la taille du bloc de mémoire destiné à l'écriture de données. La valeur par défaut de cette propriété est 10 Mo. La gamme de valeurs de cette propriété est [1 Ko, 1 Go]. En général, une valeur plus élevée pour cette propriété permet d'améliorer les performances d'écriture en allouant moins de mémoire, mais cela requiert aussi davantage de ressources système. Vous devez définir cette propriété avant le début de l'opération d'écriture. Sinon, LabVIEW renvoie une erreur.
    NI_MinimumBufferSize Nombre entier non signé 32 bits Échantillon de données Lecture/Écriture 1.0 et 2.0 Oui Vous pouvez utiliser la propriété NI_MinimumBufferSize pour améliorer les performances d'écriture des données .tdms en écrivant moins souvent dans un fichier. Cette propriété peut réduire la taille d'un fichier .tdms en contrôlant le nombre de fois que les données sont écrites sur le disque. La propriété NI_MinimumBufferSize n'est valide que si l'entrée structure des données de la fonction TDMS - Écrire est decimated. Par défaut, la valeur de la propriété NI_MinimumBufferSize est 0. Si vous définissez la valeur au niveau du groupe, cette fonction définit aussi la valeur des voies du groupe dont la valeur est 0. Si vous définissez la valeur au niveau du fichier, cette fonction définit aussi la valeur des groupes et voies du fichier dont la valeur est 0. L'utilisation de cette propriété et de la propriété NI_DiskCacheSize affecte la mise en mémoire tampon des fichiersavec les fichiers .tdms.

    NI_UpdateChannelName

    NI_UpdateGroupName

    		 Chaîne N/A Écriture seule 1.0 et 2.0 Oui Vous pouvez utiliser la fonction TDMS - Définir des propriétés pour renommer des groupes et des voies dans les fichiers .tdms. Câblez NI_UpdateGroupName à l'entrée noms des propriétés pour renommer un groupe, et câblez NI_UpdateChannelName à l'entrée noms des propriétés pour renommer une voie. Câblez les nouveaux noms des groupes ou des voies à l'entrée valeurs des propriétés et câblez les noms des groupes ou des voies que vous voulez remplacer à l'entrée nom du groupe ou nom de la voie. Si les groupes ou les voies que vous câblez à nom du groupe ou nom de la voie n'existent pas, LabVIEW crée de nouveaux groupes ou voies avec les nouveaux noms.

    Exemples

    Reportez-vous aux exemples de fichiers inclus avec LabVIEW suivants.

    • labview\examples\File IO\TDMS\Standard Read and Write\TDMS Write Time Domain Data.vi