Аннотации к графику

График хорошо показывает, что что-то изменилось. Но он не может объяснить, почему. В примечаниях к графику вы можете записать эту информацию: щелкните точку на графике Dashboard и укажите, что происходило в тот момент, чтобы в следующем месяце вы по-прежнему знали, чем был вызван этот скачок.

Аннотация привязана к показателю, зафиксированному в конкретный момент времени, а не к отдельному графику. Если вы добавите аннотацию к показателю уровня глюкозы, она отобразится на всех графиках этого показателя, независимо от уровня детализации, с которым отображается данный график.

Написание аннотации

Щелкните в любой точке графика. Откроется небольшой редактор, в котором будут отображены дата, значение в этой точке и поле для ввода вашей аннотации. Введите описание события и нажмите «Сохранить».

Записывается дата, соответствующая выбранному вами диапазону, а не момент, когда вы на него нажали. Аннотация, добавленная на месячном графике, относится к данному месяцу, поэтому она остаётся там, где вы её разместили, а не перемещается на сегодняшний день.

В одной точке можно добавить несколько аннотаций. Откройте её снова, и под уже имеющимися аннотациями появится новое поле для ввода.

Где отображаются ваши аннотации

Аннотации отображаются в виде небольших значков в полосе под графиком, выровненных по точке, к которой они относятся. Наведите курсор на значок, чтобы прочитать полный текст аннотации, или щелкните по нему, чтобы отредактировать или удалить её.

Когда несколько пометок располагаются близко друг к другу, они объединяются в одну иконку, на которой указано их количество. Нажмите на неё, и в редакторе отобразится список всех пометок, благодаря чему даже насыщенная неделя не превратится в ряд иконок, расположенных друг над другом.

Одна аннотация — для каждого графика

После измерения следуют пояснения. Из этого вытекают два момента, оба из которых являются намеренными:

• Аннотация, внесенная на дневном графике, также отображается на недельном или месячном графике того же масштаба в том же блоке данных. Достаточно внести её один раз, и она будет отображаться везде, где вы просматриваете эти данные.
• Единицы измерения не имеют значения. Пометка, сделанная на графике в милях, отображается на графике с теми же показателями, построенном в километрах, а пометка, касающаяся уровня глюкозы mg/dL, отображается на графике mmol/L.

Аннотации, прилагавшиеся к тексту для чтения

Некоторые показания поступают из ваших источников уже с прикрепленным комментарием, и для измерений, фиксирующих одно значение, таких как уровень глюкозы, содержание кислорода и температура, этот комментарий также отображается в виде аннотации.

Они помечены как относящиеся к самому измерению, поскольку являются частью показаний, а не текстом, вписанным в график. Чтобы изменить один из них, отредактируйте показания в вашем FitnessSyncer Notebook. Вы по-прежнему можете добавить собственную аннотацию к той же точке.

На каких диаграммах можно добавлять аннотации

Любой график, горизонтальная ось которого представляет время: линейный, площадной, линейный с диапазоном, столбчатый, накопленный столбчатый, график потока и бокс-плот — все они поддерживают добавление аннотаций.

Диаграммы, на которых по нижней оси отображается не время, а другие параметры, не поддерживают эту функцию, поскольку в них отсутствует дата, к которой можно привязать аннотацию. К ним относятся диаграммы рассеяния, гистограммы, тепловые карты, диаграмма «День», круговые и кольцевые диаграммы, индикаторы и плитки KPI.

Рассчитанные показатели также не предполагают добавления комментариев. Показатели «Расчетный А1С», «Процент в норме» или «Дефицит сна» рассчитываются на основе других показаний, а не регистрируются напрямую, поэтому к ним нет каких-либо показателей, которые можно было бы прокомментировать. Вместо этого добавляйте комментарии к показаниям, указанным ниже.

Если вы предпочитаете, чтобы на конкретном графике не отображались аннотации, и вы являетесь пользователем FitnessSyncer Pro, откройте настройки графика в редакторе Dashboard и отключите их для этого графика.

Ваши примечания

Значок аннотаций на панели инструментов Dashboard открывает окно «Ваши аннотации», в котором все написанные вами аннотации отображаются в одной таблице по сто штук за раз.

Там можно редактировать как дату, так и текст. Измените значение в ячейке, нажмите «Сохранить», и аннотация переместится или будет отображаться по-другому во всех местах, где она присутствует. Измерительную величину, к которой относится аннотация, изменить нельзя, поскольку в этом случае она появится на графиках, которые вы не выбирали.

Экспорт и импорт

В разделе «Ваши аннотации» также имеется кнопка «Экспорт» и раскрывающийся список для импорта, благодаря чему вы можете сохранить копию своих аннотаций или создать их пакетно в другом месте, а затем импортировать.

При экспорте каждая аннотация сохраняется в виде файла CSV с четырьмя столбцами:

• Дата: период, к которому относится аннотация; указывается в формате даты и времени по стандарту ISO в часовом поясе UTC.
• DataField: показатель, к которому относится аннотация, в формате, используемом внутренне в FitnessSyncer (например, GLUCOSE_MMOL_PER_L).
• «Измерение»: понятное название данного измерения. Этот столбец предназначен для удобства при чтении файла и игнорируется при импорте.
• Примечание: ваш текст.

При импорте считывается файл с такой же структурой. Аннотация идентифицируется по дате и значению измерения, а не по идентификатору, поэтому при импорте файла, который вы ранее экспортировали, отредактировали и снова импортировали, происходит обновление описанных в нём аннотаций, а не создание второй копии каждой из них.

Строка, которую невозможно прочитать, не приводит к остановке обработки файла. Строка, в которой указано неизвестное измерение FitnessSyncer, содержит дату, которую невозможно проанализировать, или в которой поле аннотации оставлено пустым, пропускается, и программа импорта сообщает, сколько строк было создано, сколько обновлено, сколько пропущено и какие именно строки были пропущены. Аннотации длиной более тысячи символов сокращаются, а не отбрасываются.

В приложениях

Аннотации отображаются на графиках в приложениях FitnessSyncer для iOS и Android и доступны там только для чтения. Создавать и редактировать их можно в веб-версии.