지정된 .tdms 파일, 채널 그룹 또는 채널의 프로퍼티를 설정합니다. 그룹 이름과 채널 이름 입력에 값을 연결하면 함수는 채널 레벨에서 프로퍼티를 씁니다. 그룹 이름 입력에만 값을 연결하면 채널 그룹 레벨에 프로퍼티를 씁니다. 그룹 이름과 채널 이름 입력에 모두 값이 없는 경우, 프로퍼티는 특정 파일에 제한됩니다. 채널 이름 입력에 값을 연결하는 경우, 값을 그룹 이름 입력에도 연결해야 합니다. 변경사항을 적용하려면 .tdms 파일의 참조를 닫거나 .tdms 파일로 데이터를 내보내야 합니다.


icon

입력/출력

  • c1dfxdt.png 프로퍼티 값 —

    프로퍼티 값은 지정된 채널 그룹, 채널, 또는 .tdms 파일의 프로퍼티 값을 지정합니다. 이 입력은 다음의 데이터 타입을 허용합니다.

    • 부호있는 또는 부호없는 정수
    • 다음의 특정 데이터 타입을 포함하는 부동소수:
      • 단정도 및 배정도 부동소수
      • 복소수 단정도 및 배정도 부동소수
      • (Windows) 확장형 정밀도 부동소수
    • 타임스탬프
    • 불리언
    • 널 문자를 가지고 있지 않은 문자 및 숫자 문자열
    • 위에서 지정한 모든 데이터 타입을 포함하는 배리언트

    같은 함수를 사용하여 하나 이상의 프로퍼티를 설정하려면 이전에 지정한 모든 데이터 타입의 1D 배열을 프로퍼티 값(복수) 입력에 연결할 수 있습니다. 배열의 각 값은 하나의 프로퍼티에 상응합니다. 그러나 하나의 프로퍼티는 배열 값을 가질 수 없습니다.

  • c1dstr.png 프로퍼티 이름 —

    프로퍼티 이름은 지정된 채널 그룹, 채널, 또는 tdms 파일의 프로퍼티 이름을 지정합니다.

  • cgnrn.png TDMS 파일 —

    tdms 파일은 작업을 수행할 .tdms 파일에 대한 참조 번호를 지정합니다. 참조 번호를 열려면 [TDMS 열기] 함수를 사용합니다.

  • cstr.png 그룹 이름 —

    그룹 이름은 작업을 수행할 채널 그룹을 지정합니다. 채널 이름 입력에 값을 연결하는 경우, 이 입력에도 값을 연결해야 합니다.

  • cstr.png 채널 이름 —

    채널 이름은 작업을 수행할 채널을 지정합니다. 이 입력에 값을 연결하는 경우, 그룹 이름 입력에도 값을 연결해야 합니다.

  • cerrcodeclst.png 에러 입력(에러 없음) —

    에러 입력은 이 노드의 실행 전에 발생한 에러 조건을 설명합니다. 이 입력은 표준 에러 입력 기능을 제공합니다.

  • ignrn.png TDMS 파일 출력 —

    tdms 파일 출력은 작업을 수행한 .tdms 파일에 대한 TDMS 파일 참조를 반환합니다.

  • istr.png 그룹 이름 출력 —

    그룹 이름 출력은 작업을 수행한 채널 그룹의 이름을 반환합니다.

  • istr.png 채널 이름 출력 —

    채널 이름 출력은 작업을 수행한 채널의 이름을 반환합니다.

  • ierrcodeclst.png 에러 출력 —

    에러 출력은 에러 정보를 포함합니다. 이 출력은 표준 에러 출력 기능을 제공합니다.

    • 이 섹션에서는 .tdms 파일을 사용할 때 접할 수도 있는 모든 프로퍼티를 보여줍니다. 첫 번째 테이블은 .tdms 파일에서 볼 수 있는 모든 프로퍼티를 보여줍니다. 두 번째 테이블은 .tdms 파일에는 없지만 특정 작업 수행에 사용할 수 있는 모든 프로퍼티를 보여줍니다. 이러한 프로퍼티를 .tdms 파일에 웨이브폼 속성으로 쓸 수 있습니다. 그러나, 이 프로퍼티 중 일부는 .tdms 파일로부터 웨이브폼 데이터를 읽을 때, 웨이브폼 속성으로 나타나지 않을 수도 있습니다. 웨이브폼 속성으로 사용 가능? 열은 프로퍼티가 웨이브폼 속성으로 사용 가능한지에 대한 정보를 제공합니다. 프로퍼티의 데이터 타입이 유효하지 않은 경우, LabVIEW는 이 프로퍼티를 사용자 정의된 프로퍼티로 처리하기 때문에 프로퍼티는 테이블에 설명된 기능을 수행하지 않습니다.

    [TDMS 프로퍼티 얻기] 함수를 사용하여 이러한 프로퍼티의 값을 얻을 수 있습니다. [TDMS 프로퍼티 설정] 함수를 사용하여 이러한 프로퍼티의 값을 변경합니다.

    다음 테이블은 .tdms 파일에서 볼 수 있는 모든 프로퍼티를 보여줍니다.

    프로퍼티 이름 데이터 타입 접근 파일 포맷 버전에서 사용 가능 웨이브폼 속성으로 사용 가능? 설명
    name 문자열 읽기/쓰기 2.0 예 .tdms 파일에서 루트 이름, 그룹 이름, 채널 이름 등의 객체 이름을 지정합니다.
    NI_ArrayColumn 32비트 부호있는 정수 읽기 전용 1.0과 2.0 아니오 2D 배열의 열 인덱스를 나타냅니다. 이 프로퍼티는 2D 배열의 데이터를 파일에 쓰는 경우에만 .tdms 파일 내에 나타납니다.
    NI_ChannelLength 64비트 부호없는 정수 읽기 전용 1.0과 2.0 예 .tdms 파일의 채널에 있는 값의 개수를 나타냅니다.
    NI_DataType 16비트 부호없는 정수 읽기 전용 1.0과 2.0 예

    채널의 데이터 타입을 나타냅니다. 값은 LabVIEW 타입 코드에 대응하는 정수입니다.

    노트 .tdms 파일은 다음 데이터 유형에 대해 LabVIEW 유형 코드와 다른 유형 코드를 사용합니다:
    • 문자열: 0x20
    • 불리언: 0x21
    • 타임스탬프: 0x44
    • 고정 소수점 숫자: 0x4F
    • 단위가 포함된 단정도 부동소수: 0x19
    • 복소수 단정도 부동소수: 0x08000c
    • 복소수 배정도 부동소수: 0x10000d
    • DAQmx 원시 데이터 : 0xFFFFFFFF

    TDMS 데이터 유형 코드의 전체 목록은 TDMS 파일 형식 내부 구조의데이터 유형 값 섹션을 참조하세요.

    NI_DigitalCompression 불리언 읽기 전용 1.0과 2.0 아니오 디지털 테이블이 압축되어 있는지 나타냅니다. 1의 값은 디지털 테이블이 압축되었음을 나타냅니다. 디지털 테이블이 압축되지 않은 경우, 이 프로퍼티는 나타나지 않습니다.
    NI_DigitalLine 32비트 부호있는 정수 읽기 전용 1.0과 2.0 아니오 디지털 테이블에 있는 행의 인덱스를 지정합니다.
    NI_DigitalNumberOfLines 32비트 부호있는 정수 읽기 전용 1.0과 2.0 아니오 디지털 테이블에 있는 열의 개수를 지정합니다.
    NI_Number_Of_Scales 32비트 부호없는 정수 읽기/쓰기 2.0 아니오 .tdms 파일에서 데이터를 읽을 때 사용하는 스케일의 개수를 지정합니다. 예를 들어 .tdms 파일이 5개의 스케일을 가지고 있으며 NI_Number_Of_Scales의 값을 4로 설정한 경우, LabVIEW는 .tdms 파일을 읽을 때 데이터에 처음 4개의 스케일만을 적용합니다.
    NI_Scale[n]여기서 n은 척도의 순서를 나타내고 config는 척도의 구성을 나타냅니다. 해당 없음 읽기/쓰기 2.0 아니오 .tdms 파일에 있는 데이터의 스케일 정보를 지정합니다. 끼워넣은 데이터를 .tdms 파일에 쓸 수 있습니다.
    노트 내쇼날인스트루먼트는 TDMS 스케일링 정보 생성 VI를 사용하여 스케일을 생성할 것을 권장합니다.
    NI_Scaling_Status 문자열 읽기/쓰기 2.0 아니오 .tdms 파일에서 데이터를 읽을 때 LabVIEW가 데이터를 스케일할지 여부를 지정합니다. 값이 unscaled이고 .tdms 파일에 하나 또는 그 이상의 스케일이 포함된 경우, LabVIEW는 데이터를 스케일합니다. 값이 scaled인 경우, LabVIEW는 데이터를 스케일하지 않습니다. DAQmx 데이터 채널의 경우, LabVIEW는 NI_Scaling_Status가 unscaled일 때에도 스케일하지 않은 데이터를 반환할 수 없습니다.
    unit_string 문자열 읽기/쓰기 1.0과 2.0 아니오 .tdms 파일에 있는 채널 데이터의 단위를 지정합니다.
    wf_increment 배정도 읽기/쓰기 1.0과 2.0 아니오 x축에 있는 두 개의 연속적인 샘플 사이의 증가분을 나타냅니다.
    wf_samples 32비트 부호있는 정수 읽기/쓰기 1.0과 2.0 아니오 .tdms 파일에 쓰는 웨이브폼의 첫 번째 데이터 그룹의 샘플 개수를 나타냅니다. 이 값은 반드시 제로보다 커야 합니다.
    wf_start_offset 배정도 읽기 전용 1.0과 2.0 아니오 주파수 영역 데이터와 히스토그램 결과는 이 값을 x축의 첫 번째 값으로 사용합니다.
    wf_start_time 타임스탬프 읽기 전용 1.0과 2.0 아니오 웨이브폼이 수집되거나 생성된 시간을 나타냅니다. 시간 정보가 상대적이거나 웨이브폼이 시간 영역에 있지 않은 경우 이 프로퍼티는 제로가 될 수 있습니다.
    wf_time_pref 문자열 읽기 전용 1.0과 2.0 아니오 LabVIEW가 x축 데이터를 절대 시간으로 해석하는지 아니면 상대 시간으로 해석하는지 나타냅니다.
    wf_xname 문자열 읽기 전용 1.0과 2.0 아니오 웨이브폼의 x축 이름을 나타냅니다.
    wf_xunit_string 문자열 읽기 전용 1.0과 2.0 아니오 x 축의 단위 텍스트를 나타냅니다.

    위에 있는 테이블의 프로퍼티뿐만 아니라 .tdms 파일에는 다른 웨이브폼 속성도 포함되어 있을 수 있습니다.

    다음 테이블은 .tdms 파일에는 없지만 특정 작업 수행에 사용할 수 있는 모든 프로퍼티를 보여줍니다.

    프로퍼티 이름 데이터 타입 단위 접근 파일 포맷 버전에서 사용 가능 웨이브폼 속성으로 사용 가능? 설명
    NI_DiskCacheSize 32비트 부호없는 정수 바이트 읽기/쓰기 2.0 예 NI_DiskCacheSize 프로퍼티를 사용하여, 메모리에서 일정 양의 캐시 크기를 .tdms 데이터에 할당함으로써 .tdms 데이터 쓰기 성능을 향상시킬 수 있습니다. LabVIEW는 파일마다 바이트 단위로 .tdms 데이터를 씁니다. 이 프로퍼티는 [TDMS 열기] 함수의 버퍼링 비활성화? 입력이 참일 때에만 유효합니다. 이 프로퍼티의 기본값은 약 2 MB입니다. [TDMS 프로퍼티 설정] 함수의 프로퍼티 값 입력에 다른 값을 연결하면 캐시 크기가 변경됩니다. NI_DiskCacheSize 프로퍼티의 값이 커지면 일반적으로 쓰기 성능이 향상됩니다. 그러나 동시에 컴퓨터 리소스도 더욱 많이 필요합니다.
    NI_DiskGapSize 32비트 부호없는 정수 바이트 읽기/쓰기 2.0 예 NI_DiskGapSize 프로퍼티를 사용하면, 비연속적인 데이터를 읽을 때 .tdms 데이터 읽기 성능을 향상시킬 수 있습니다. 이 프로퍼티는 [TDMS 열기] 함수의 버퍼링 비활성화? 입력이 참일 때에만 유효합니다. NI_DiskGapSize 프로퍼티의 값은 로컬 하드 디스크 섹터 크기의 배수입니다. 이 프로퍼티의 기본값은 10입니다. .tdms 파일의 데이터 갭이 NI_DiskGapSize 프로퍼티의 값보다 적은 경우, [TDMS 읽기] 함수는 한 번에 파일에서 모든 데이터를 읽을 수 있습니다. .tdms 파일의 데이터 갭이 NI_DiskGapSize 프로퍼티의 값보다 큰 경우, [TDMS 읽기] 함수는 모든 데이터를 읽는 것을 완료할 때까지 데이터의 각 조각을 한 번에 하나씩 읽습니다. [TDMS 프로퍼티 설정] 함수의 프로퍼티 값 입력에 값을 연결하면 갭 크기가 변경됩니다.
    노트 최적의 읽기와 쓰기 성능은 시행착오를 겪으면서 파악하는 것입니다. 같은 설정이라고 해도 컴퓨터가 다르면 같은 최적 성능을 내지 못할 수도 있습니다. 한 컴퓨터에서 다른 컴퓨터로 어플리케이션을 배포한 후에는 프로퍼티 값을 조절해야 할 수도 있습니다.
    NI_InMemoryFileSize 64비트 부호있는 정수 바이트 읽기 전용 2.0 예 NI_InMemoryFileSize 프로퍼티를 사용하여 메모리상 .tdms 파일의 크기를 반환할 수 있습니다.
    NI_InMemoryWriteBlockSize 64비트 부호있는 정수 바이트 읽기/쓰기 2.0 예 NI_InMemoryWriteBlockSize 프로퍼티를 사용하여 데이터를 쓰는데 사용할 메모리상 블록 크기를 할당합니다. 이 프로퍼티의 기본값은 10 MB입니다. 이 프로퍼티의 기본 범위는 [1 KB, 1 GB]입니다. 이 프로퍼티의 값이 더 높으면 보다 적은 블록을 할당하여 메모리상 쓰기 성능이 향상되지만, 또한 필요로 하는 컴퓨터 리소스가 증가하게 됩니다. 이 프로퍼티는 반드시 쓰기 작업을 시작하기 전에 설정되어야 합니다. 그렇지 않은 경우, LabVIEW는 에러를 반환합니다.
    NI_MinimumBufferSize 32비트 부호없는 정수 데이터 샘플 읽기/쓰기 1.0과 2.0 예 NI_MinimumBufferSize 프로퍼티를 사용하여, 파일에 쓰는 빈도수를 줄임으로써 .tdms 데이터 쓰기 성능을 향상시킬 수 있습니다. 이 프로퍼티를 통해 데이터를 디스크에 쓰는 횟수를 조절함으로써 .tdms 파일의 크기를 줄일 수 있습니다. NI_MinimumBufferSize 프로퍼티는 [TDMS 쓰기] 함수의 데이터 레이아웃 입력이 decimated일 때에만 유효합니다. NI_MinimumBufferSize 프로퍼티의 기본값은 0입니다. 그룹 레벨에서 이 값을 설정하면, 이 함수는 그 밑의 채널 중 값이 0인 채널의 값도 설정합니다. 파일 레벨에서 이 값을 설정하면, 이 함수는 그 밑의 채널 중 값이 0인 그룹과 채널의 값도 설정합니다. 이 속성과 NI_DiskCacheSize 속성을 사용하면 .tdms 파일의파일 버퍼링에영향을 줍니다.

    NI_UpdateChannelName

    NI_UpdateGroupName

    		 문자열 해당 없음 쓰기 전용 1.0과 2.0 예 [TDMS 프로퍼티 설정] 함수를 사용하여 .tdms 파일의 그룹과 채널의 이름을 변경할 수 있습니다. 그룹의 이름을 변경하려는 경우 NI_UpdateGroupName을 프로퍼티 이름 입력에 연결하고, 채널의 이름을 변경하려는 경우 NI_UpdateChannelName을 프로퍼티 이름 입력에 연결합니다. 새 그룹이나 채널 이름을 프로퍼티 값 입력에 연결하고, 대체하려는 그룹이나 채널 이름을 그룹 이름 이나 채널 이름 입력에 연결합니다. 그룹 이름이나 채널 이름에 연결한 그룹이나 채널이 존재하지 않는 경우, LabVIEW는 새 이름을 가진 새 그룹이나 채널을 생성합니다.

    예제

    LabVIEW 포함되는 다음 예제 파일을 참조하십시오.

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