`addevent`

Adiciona eventos a um objeto timeseries.

Categoria: Language Fundamentals > Data Types

Sintaxe

ts = addevent(ts, e, time)

Anexa o evento e à série temporal ts no instante time.

Descrição

Um evento é um marcador com nome, como "pico" ou "reinício do sensor", associado a um instante. Não altera os dados; é metadado usado para rotular gráficos ou selecionar intervalos da série. Crie eventos com tsdata.event(nome, tempo).

Argumentos de entrada

ts: Um objeto timeseries.
e: Objeto de evento criado com tsdata.event, ou um array deles.
time: Instante do evento, na escala de tempo de ts.

Argumentos de saída

ts: A série temporal com o evento armazenado.

Exemplo

Marcar um instante

ts = timeseries([10 20 30]', [0 1 2]);
e = tsdata.event('peak', 1);
ts = addevent(ts, e, 1);
disp(size(ts.Events))

Saída

     1     1

Observações

No MatLivre os eventos armazenados são retornados como cell array, e não como um array de objetos de evento.

Veja também

timeseries tsdata.event addsample delevent