eventtable

📝Syntaxe

E = eventtable(eventTimes)
E = eventtable(TT)
E = eventtable(___, 'EventLabels', labels)
E = eventtable(___, 'EventLengths', lengths)
E = eventtable(___, 'EventEnds', ends)
E = eventtable(___, 'EventLabelsVariable', name)
E = eventtable(___, 'EventLengthsVariable', name)
E = eventtable(___, 'EventEndsVariable', name)

📥Arguments d'entrée

Paramètre	Description
eventTimes	Vecteur datetime ou duration contenant les temps de debut des evenements.
TT	Timetable dont les temps de lignes deviennent les temps d'evenements et dont les variables deviennent les variables d'evenements.
labels	Etiquettes d'evenements. Une valeur scalaire est etendue a tous les evenements.
lengths	Valeurs duration qui indiquent les durees d'evenements.
ends	Valeurs datetime ou duration qui indiquent les fins d'evenements.
name	Nom ou indice d'une variable du timetable d'entree contenant les etiquettes, durees ou fins d'evenements. Valide seulement si la premiere entree est un timetable.

📤Arguments de sortie

Paramètre	Description
E	Eventtable : un timetable dont les temps de lignes sont les temps d'evenements.

📄Description

eventtable cree une eventtable qui peut etre attachee a un timetable avec Properties.Events ; syncevents copie ensuite ses variables dans le timetable.

Quand l'entree est un vecteur de temps, les etiquettes, durees et fins d'evenements sont indiquees par des arguments nom-valeur. Les variables supplementaires sont fournies en creant d'abord un timetable puis en le passant a eventtable : toute entree positionnelle apres la premiere est une erreur.

Une eventtable est un timetable : les temps d'evenements sont ses temps de lignes (E.Properties.RowTimes, ou E.Time) et non une variable ; size, width, l'indexation et la concatenation se comportent comme pour un timetable.

E.Properties commence par EventLabelsVariable, EventLengthsVariable et EventEndsVariable, les noms des variables contenant les etiquettes, durees et fins d'evenements ([] si non definies). On peut leur affecter un nom ou un indice de variable, ou []. Une variable renommee ou supprimee n'est plus utilisee.

Creee a partir de temps d'evenements sans etiquettes, l'eventtable recoit les etiquettes "Event 1", "Event 2", ... dans une variable EventLabels. Creee a partir d'un timetable, aucune variable ne sert d'etiquettes sauf indication contraire.

💡Exemples

eventTimes = datetime(2022, 11, [3; 5; 10; 14]);
eventType = {'Hail'; 'Rain'; 'Snow'; 'Rain'};
eventLength = hours([1.2; 36; 18; 20]);
E = eventtable(eventTimes, ...
  'EventLabels', eventType, ...
  'EventLengths', eventLength)

t = datetime(2022, 11, (1:15)');
temperature = [36; 31; 37; 36; 38; 32; 35; 34; 32; 30; 39; 34; 31; 40; 34];
humidity = [45; 76; 43; 46; 72; 54; 50; 45; 72; 58; 54; 58; 73; 78; 66];
TT = timetable(t, temperature, humidity, 'VariableNames', {'Temperature', 'Humidity'});
eventTimes = t([3; 5; 10; 14]);
eventType = {'Hail'; 'Rain'; 'Snow'; 'Rain'};
eventLength = hours([1.2; 36; 18; 20]);
precipitation = [12.7; 114.3; 25.4; 177.8];
eventData = timetable(eventTimes, eventType, eventLength, precipitation, ...
  'VariableNames', {'EventType', 'EventLength', 'Precipitation'});
E = eventtable(eventData, ...
  'EventLabelsVariable', 'EventType', ...
  'EventLengthsVariable', 'EventLength');
TT.Properties.Events = E;
stackedplot(TT)