이 페이지는 기계 번역을 사용하여 번역되었습니다. 영어 원문을 보려면 여기를 클릭하십시오.

DataAcquisition

데이터 수집 장치 인터페이스

페이지 내 모두 확장

설명

DataAcquisition 객체는 지정된 공급업체의 장치에 대한 액세스를 제공합니다.

생성

daq 함수를 사용하여 DataAcquisition 객체를 생성합니다.

속성

모두 확장

`AutoSyncDSA` — DSA 장치를 자동으로 동기화할지 여부
false (디폴트 값) | true

DSA 장치를 자동으로 동기화할지 여부로, 논리형 true 또는 false로 지정됩니다. 이 속성을 사용하여 동일한 DataAcquisition에 있는 DSA(PXI 또는 PCI) 장치 간 자동 동기화를 활성화하거나 비활성화합니다. 기본적으로 자동 동기화 기능은 비활성화되어 있습니다.

예: true

데이터형: logical

`Channels` — 장치 채널
읽기 전용: 채널 객체 배열

읽기 전용 속성입니다.

장치 채널로, 채널 객체의 배열로 반환됩니다. addinput, addoutput, addbidirectional 함수를 사용하여 채널을 만듭니다.

예: addinput(d,…)

`Clocks` — 장치 클록 연결
읽기 전용: `clock` 객체로 구성된 배열

읽기 전용 속성입니다.

장치 클록 연결로, 클록 객체의 배열로 반환됩니다. addclock 함수를 사용하여 클록을 만듭니다.

예: addclock(d,…)

`DigitalTriggers` — 장치 디지털 트리거 연결
읽기 전용: `DigitalTrigger` 객체로 구성된 배열

읽기 전용 속성입니다.

장치 디지털 트리거 연결로, DigitalTrigger 객체의 배열로 반환됩니다. addtigger 함수를 사용하여 DataAcquisition에 디지털 트리거를 추가합니다.

예: addtrigger(d,…)

`DigitalTriggerTimeout` — 디지털 트리거 발생에 허용된 시간
10 (디폴트 값) | 숫자형 | 기간

디지털 트리거가 발생하는 데 허용되는 시간으로, 초 단위의 숫자형 값이나 지속 시간으로 지정됩니다.

예: 30

`ErrorOccurredFcn` — 오류 발생 시 호출할 콜백 함수
함수 핸들

오류가 발생할 때 호출할 콜백 함수로, 함수 핸들로 지정됩니다.

예: @mycleanup

데이터형: function_handle

`LogToDisk` — TDMS 파일 기록 지정
`false` (디폴트 값) | true

TDMS 파일에 데이터를 기록할지 여부를 제어하며, true 또는 false(디폴트 값)로 지정됩니다.

예: dq.LogToDisk = true

데이터형: logical

`LogFileMode` — TDMS 파일에 기록할 때의 쓰기 모드
`"append"` (디폴트 값) | `"overwrite"` | `"new"`

TDMS 파일에 기록할 때의 쓰기 모드로, string형 또는 문자형 벡터로 지정됩니다. 지원되는 값은 다음과 같습니다.

"append" — 기존 파일에 데이터를 추가합니다. 기존 데이터는 보존되고, 기존 데이터 다음에 새 데이터가 새 채널 그룹에 추가됩니다.
"overwrite" — 기존 파일을 새 데이터로 덮어씁니다. 이전 데이터는 손실됩니다.
"new" — 새로운 파일을 만듭니다. 파일이 이미 존재하는 경우 오류가 발생합니다.

예: dq.LogFileMode = "overwrite"

데이터형: char | string

`LogFileName` — 데이터를 기록할 TDMS 파일 이름
string | char

데이터를 기록할 TDMS 파일의 이름으로, string형 또는 문자형 벡터로 지정됩니다. 기본 파일 이름은 "recording_YYYYMMDD-HHMMSS.tdms" 형식입니다.

예: dq.LogFileName = "MyDataFile_2.tdms"

데이터형: char | string

`NumDigitalTriggersRemaining` — 실행 중 남은 디지털 트리거 수
읽기 전용: 1 (디폴트 값) | 숫자형

읽기 전용 속성입니다.

실행 중에 남아 있는 디지털 트리거의 수로, double형으로 반환됩니다.

예: 1

데이터형: double

`NumDigitalTriggersPerRun` — DataAcquisition 실행당 디지털 트리거 수
숫자형

DataAcquisition 실행 당 디지털 트리거 수로, double형으로 반환됩니다.

예: 2

데이터형: double

`NumScansAcquired` — 마지막 시작 이후 수집한 데이터 스캔 수
읽기 전용: 숫자형

읽기 전용 속성입니다.

마지막 start 이후 백그라운드 작업에서 수집된 데이터 스캔 수로, uint64 값으로 반환됩니다. 이 값은 start가 호출될 때마다 재설정되며, 스캔이 MATLAB로 읽혔는지 여부를 반영하지 않습니다.

예: 1000

데이터형: uint64

`NumScansAvailable` — 수집하여 읽을 수 있는 데이터 스캔 수
읽기 전용: 숫자형

읽기 전용 속성입니다.

읽을 수 있는 데이터 스캔 수로, uint64 값으로 반환됩니다. 이러한 스캔은 백그라운드 작업에서 장치 입력 채널을 통해 수집되었지만 아직 MATLAB로 읽혀지지 않았습니다. 값은 read를 호출할 때마다 감소하고, start를 호출하면 재설정됩니다.

예: 1000

데이터형: uint64

`NumScansOutputByHardware` — 장치 출력으로 생성된 스캔 수
읽기 전용: 숫자형

읽기 전용 속성입니다.

장치 출력으로 생성된 스캔 수로, uint64 값으로 반환됩니다.

예: 1024

데이터형: uint64

`NumScansQueued` — 장치 출력을 위해 준비된 스캔 수
읽기 전용: 숫자형

읽기 전용 속성입니다.

장치 출력 채널에 대기 중인 스캔 수로, uint64 값으로 반환됩니다.

예: 4000

데이터형: uint64

`Rate` — 데이터 스캔 레이트
숫자형

데이터 스캔 레이트로, 초당 샘플의 숫자형 값으로 지정됩니다.

예: 44100

`RateLimit` — 스캔 레이트 제한의 하한 및 상한
읽기 전용: double형으로 구성된 배열

읽기 전용 속성입니다.

스캔 레이트 제한의 하한 및 상한으로, 초당 샘플 수로 허용되는 최소 및 최대 스캔 레이트를 나타내는 double형의 1×2 벡터로 반환됩니다. 스캔 레이트 제한은 하드웨어와 구성에 따라 달라집니다. 채널을 변환기로 다중화하는 장치에서는 속도 제한이 사용하는 채널 수의 영향을 받습니다. 자세한 내용은 Sampling 항목을 참조하십시오.

예: [8000 192000]

데이터형: double

`Running` — DataAcquisition 실행 표시
읽기 전용: true | false

읽기 전용 속성입니다.

DataAcquisition 실행 표시로, true 또는 false로 반환됩니다.

예: true

데이터형: logical

`ScansAvailableFcn` — 스캔이 가능할 때 콜백 함수
함수 핸들

입력 채널에서 스캔이 사용 가능할 때 실행할 콜백 함수(함수 핸들로 지정됨)

예: @read

데이터형: function_handle

`ScansAvailableFcnCount` — `ScansAvailableFcn`를 트리거하기 위한 수집된 스캔 수
숫자형

ScansAvailableFcn를 트리거하기 위한 수집된 스캔 수로, 숫자형 값으로 지정됩니다. ScansAvailableFcn에 지정된 함수 핸들은 입력 채널에서 ScansAvailableFcnCount 스캔이 수집될 때마다 실행됩니다. 디폴트 값은 해당 DataAcquisition 객체의 속도의 1/10이고, 하한값은 1/20입니다.

예: 8000

`ScansRequiredFcn` — 출력 스캔 데이터가 필요할 때의 콜백 함수
함수 핸들

장치 출력 채널에 스캔 데이터가 필요할 때 실행할 콜백 함수로, 함수 핸들로 지정됩니다.

예: @write

데이터형: function_handle

`ScansRequiredFcnCount` — `ScansRequiredFcn`를 트리거할 스캔 수
`"auto"` (디폴트 값) | 숫자형

ScansRequiredFcn를 트리거하기 위해 대기열에 추가된 스캔 수이며, 숫자형 값이나 "auto"로 지정됩니다. ScansRequiredFcn에 지정된 함수 핸들은 NumScansQueued가 이 속성에 지정된 값보다 낮아지면 실행됩니다. 디폴트 값은 해당 DataAcquisition 객체의 속도의 1/2이고, 하한값은 1/20입니다. 이 속성을 "auto"로 설정하면 디폴트 값으로 재설정됩니다.

예: 2000

`UserData` — 사용자 지정 데이터
모든 데이터

사용자 지정 데이터로, MATLAB^® 데이터 유형 및 형식으로 지정됩니다.

예: datetime('now')

`Vendor` — 데이터 수집 하드웨어 공급업체 정보
읽기 전용: 공급업체 객체

읽기 전용 속성입니다.

데이터 수집 하드웨어 공급업체 정보로, 다음 속성을 가진 공급업체 객체로 반환됩니다.

ID
FullName
AdaptorVersion
DriverVersion
IsOperational

이 객체는 daqvendorlist 함수가 반환하는 해당 공급업체 객체와 동일합니다.

`WaitingForDigitalTrigger` — 디지털 트리거 대기 표시
읽기 전용: false (디폴트 값) | true

읽기 전용 속성입니다.

디지털 트리거 대기 표시로, 논리형으로 반환됩니다.

예: true

데이터형: logical

객체 함수

`addinput`	장치 인터페이스에 입력 채널 추가
`read`	하드웨어로 수집한 데이터 읽기
`readwrite`	장치 채널 데이터를 동시에 읽고 쓰기
`start`	`DataAcquisition` 백그라운드 작업 시작
`stop`	백그라운드 작업 중지
`removechannel`	장치 인터페이스에서 채널 제거
`flush`	DataAcquisition 입력 및 출력 버퍼 플러시
`write`	하드웨어 채널에 출력 스캔 쓰기
`preload`	장치 출력을 위한 대기열 스캔 데이터
`addoutput`	장치 인터페이스에 출력 채널 추가
`addbidirectional`	장치 인터페이스에 디지털 양방향 채널 추가
`resetcounters`	모든 카운터 입력의 하드웨어 스캔 카운트를 초기화
`addclock`	장치 인터페이스에 클록연결 추가
`removeclock`	Remove clock from device interface
`addtrigger`	장치 인터페이스에 트리거 연결 추가
`removetrigger`	장치 인터페이스에서 트리거 제거

예제

모두 축소