synchronize

공통 시간 벡터를 사용하여 두 개의 timeseries 객체 동기화 및 리샘플링

구문

[ts1,ts2] = synchronize(ts1,ts2,synchronizemethod)

[ts1,ts2] = synchronize(___,Name,Value)

설명

참고

이 synchronize 함수는 timeseries 함수를 사용하여 만든 객체에 적용됩니다. timetable(timeseries보다 권장됨)을 동기화하는 방법에 대한 자세한 내용은 synchronize 항목을 참조하십시오.

[ts1,ts2] = synchronize(ts1,ts2,synchronizemethod)는 공통 시간 벡터와 지정된 방법을 사용하여 ts1과 ts2를 동기화하여 두 개의 새로운 timeseries 객체를 만듭니다.

[ts1,ts2] = synchronize(___,Name,Value)는 위에 열거된 구문에 하나 이상의 Name,Value 쌍 인수로 지정된 추가 옵션을 사용하여 두 개의 새 timeseries 객체를 만듭니다.

예제

timeseries 객체 동기화하기

ts1.timeinfo.StartDate가 ts2.timeinfo.StartDate보다 1일 뒤가 되도록 두 개의 timeseries 객체를 만듭니다.

ts1 = timeseries([1 2],[datestr(now); datestr(now+1)]);
ts2 = timeseries([1 2],[datestr(now-1); datestr(now)]);

ts1.timeinfo.StartDate가 ts2.timeinfo.StartDate와 일치하도록 변경하고 ts1.Time을 1로 변경합니다.

[ts1 ts2] = synchronize(ts1,ts2,'union');

다음 명령은 ts1.timeinfo.StartDate를 유지하고 ts1.Time을 0으로 유지합니다.

[ts1 ts2] = synchronize(ts1,ts2,'union','KeepOriginalTimes',true);

입력 인수

ts1 — 첫 번째 입력 timeseries

스칼라

첫 번째 입력 timeseries로, 스칼라로 지정됩니다.

데이터형: timeseries

ts2 — 두 번째 입력 timeseries

스칼라

두 번째 입력 timeseries로, 스칼라로 지정됩니다.

데이터형: timeseries

synchronizemethod — 동기화 방법

'Union' | 'Intersection' | 'Uniform'

동기화 방법으로, 다음 옵션 중 하나로 지정됩니다.

• 'Union' — 두 개의 시간 벡터가 겹치는 시간 범위에서 ts1과 ts2 시간 벡터의 합집합인 시간 벡터를 사용하여 timeseries 객체를 리샘플링합니다.

• 'Intersection' — ts1과 ts2 시간 벡터의 교집합인 시간 벡터에서 timeseries 객체를 리샘플링합니다.

• 'Uniform' — 다음과 같은 추가 인수가 필요합니다.

  [ts1,ts2] = synchronize(ts1,ts2,'Uniform','Interval',value)
  

  이 방법은 등간격 시간 벡터에서 시계열을 리샘플링하며, 여기서 value는 두 연속 샘플 사이의 시간 간격을 지정합니다. 등간격 시간 벡터는 ts1과 ts2 시간 벡터의 중첩입니다. 간격의 단위는 ts1 및 ts2의 단위보다 작습니다.

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: [ts1,ts2] = synchronize(ts1,ts2,'tolerance',1e-13)

InterpMethod — 보간 방법

'linear' (디폴트 값) | 'zoh'

동기화 작업을 위한 보간 방법으로, 선형 보간의 경우 'linear' 또는 영차 유지의 경우 'zoh'로 지정됩니다. 보간 방법은 사용자 정의 보간 방법을 포함하는 tsdata.interpolation 객체로 지정될 수도 있습니다.

QualityCode — 품질 코드

[] (디폴트 값) | 스칼라 | 벡터 | 다차원 배열

품질 코드로, [] 또는 -128부터 127까지의 정수로 구성된 스칼라, 벡터 또는 다차원 배열로 지정됩니다.

• 품질 코드 값이 벡터인 경우 시간 벡터와 길이가 같아야 합니다. 각 요소는 대응하는 데이터 샘플에 적용됩니다.

• 품질 코드 값이 배열인 경우 데이터 배열과 크기가 같아야 합니다. 각 요소는 데이터 배열의 대응하는 데이터 요소에 적용됩니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

KeepOriginalTimes — 원래 시간 표시자

true | false

원래 시간 벡터로, 원래 시간 값을 유지하기 위해 true로 지정되거나, 다른 시간 값을 사용하기 위해 false로 지정됩니다.

데이터형: logical

tolerance — 허용오차

1e-10 (디폴트 값) | 실수 숫자형 스칼라

허용오차로, ts1과 ts2의 두 시간 값 사이에서 구별하기 위한 허용오차를 정의하는 실수 숫자형 스칼라로 지정됩니다. 예를 들어, ts1의 여섯 번째 시간 값이 5+(1e-12)이고 ts2의 여섯 번째 시간 값이 5-(1e-13)인 경우 두 값 모두 기본적으로 5로 처리됩니다. 두 시간을 구별하기 위해 'tolerance'를 1e-15와 같은 더 작은 값으로 설정할 수 있습니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

출력 인수

ts1 — 첫 번째 출력 timeseries

스칼라

동기화 및 리샘플링된 첫 번째 출력 timeseries로, 스칼라로 지정됩니다.

데이터형: timeseries

ts2 — 두 번째 출력 timeseries

스칼라

동기화 및 리샘플링된 두 번째 출력 timeseries로, 스칼라로 지정됩니다.

데이터형: timeseries

버전 내역

R2006a 이전에 개발됨

참고 항목

timeseries | synchronize