チャートの注釈

グラフは、何かが変化したことを示すのには役立ちます。しかし、その理由までは教えてくれません。その理由を書き留めるのが、グラフの注釈です。Dashboardのグラフ上のポイントをクリックして、その時点で何が起きていたかを記録しておけば、来月になってもその急上昇の原因がわかるようになります。

注釈は、特定の時点での測定値に紐づくものであり、個々のグラフに紐づくものではありません。血糖値に注釈を付けると、そのグラフがどの粒度で表示されていても、その血糖値に関するすべてのグラフに注釈が表示されます。

注釈の書き方

チャート上の任意の地点をクリックしてください。日付、その地点の値、および注釈を入力するためのボックスが表示された小さなエディタが開きます。何が起きたかを入力し、「保存」をクリックしてください。

記録される日付は、クリックした「バケット」の日付であり、クリックした瞬間ではありません。月次チャートに書き込まれた注釈はその月に関するものであるため、今日の日付に移動することなく、配置した場所にそのまま残ります。

同じポイントに複数の注釈を追加することができます。再度開くと、既存の注釈の下に新しい入力ボックスが表示されます。

注釈が表示される場所

注釈は、グラフの下にあるレーン上に、対応するポイントと位置が一致するように小さなチップとして表示されます。チップにカーソルを合わせると注釈全文が表示され、クリックすると編集または削除できます。

複数の注釈が近くに重なっている場合、それらは1つのチップに統合され、その数が表示されます。これをクリックすると、エディタにすべての注釈が一覧表示されるため、忙しい週でもチップが重なり合って並ぶようなことはありません。

1つの注釈で、すべてのチャートに対応

測定値の後に注釈が続きます。そこから2つのことが導き出されますが、いずれも意図的なものです：

• 日足チャートに書き込まれた注釈は、同じ時間軸の週足や月足チャート上でも、その注釈が含まれる範囲内に表示されます。一度書き込めば、そのデータをどこで表示しても表示されます。
• 単位は関係ありません。マイル単位で書かれた注記は、キロメートル単位で描かれた同じ測定値の図表にも表示され、mg/dLの血糖値に関する注記はmmol/Lの図表にも表示されます。

その読書に付随していた注釈

ソースから送信される測定値の中には、すでにコメントが添付されているものがあります。また、血糖値、酸素濃度、温度など、単一の値を記録する測定値については、そのコメントも注釈として表示されます。

これらは、グラフ上に書き込まれたものではなく、測定値そのものの一部であるため、測定値自体に属するものとしてマークされています。これらを変更するには、FitnessSyncer Notebook内の測定値を編集してください。同じポイントに独自の注釈を追加することは可能です。

どのチャートに注釈を付けられますか

横軸が時間であるグラフ（折れ線グラフ、面グラフ、範囲付き折れ線グラフ、棒グラフ、積み上げ棒グラフ、ストリームグラフ、箱ひげ図）はすべて、注釈を追加できます。

下部に時間以外の軸が表示されるグラフでは、注釈を付ける日付が存在しないため、注釈は表示されません。これには、散布図、ヒストグラム、ヒートマップ、「Day」チャート、円グラフおよびドーナツグラフ、ゲージ、KPIタイルが含まれます。

計算された測定値にも注釈は付けられません。「推定A1C」、「目標範囲内率」、または「睡眠不足」は、記録された値ではなく他の測定値から算出されるため、そこにコメントを付けるべき測定値が存在しないのです。代わりに、その下の測定値に注釈を記入してください。

特定のチャートに注釈を表示させたくない場合で、かつFitnessSyncer Proユーザーである場合は、Dashboardエディタでそのチャートの設定（）を開き、そのチャートについて注釈をオフにしてください。

あなたの注釈

Dashboard ツールバーにある注釈アイコン「」をクリックすると、「注釈一覧」が開きます。この画面には、作成したすべての注釈が1つの表に、一度に100件ずつ一覧表示されます。

そこでは日付もテキストも編集可能です。セルを変更して「保存」を押すと、その注釈が表示されているすべての場所で位置が変わったり、表示内容が変更されたりします。注釈が紐付けられている測定値は変更できません。変更すると、選択していないグラフに注釈が移動してしまうためです。

エクスポートとインポート

「注釈」には「エクスポート」ボタンとインポート用のドロップボックスも用意されているため、注釈のコピーを保存したり、別の場所でまとめて作成した注釈を取り込んだりすることができます。

ダウンロードしたすべての注釈を、4つの列からなるCSVファイルとしてエクスポートします：

• 日付：注釈が適用される日時。UTC 形式の ISO 日付および時刻で表記されます。
• DataField：アノテーションが対象とする測定値。GLUCOSE_MMOL_PER_L など、FitnessSyncer が内部で使用している形式で指定します。
• 測定値：その測定値の読みやすい名称。この列は、ファイルを読み取る際に参照しやすいように設けられたものであり、インポート時には無視されます。
• 注：あなたのテキスト。

「インポート」では、同じ形状のファイルを読み込みます。アノテーションは ID ではなく、日付と測定値によって識別されるため、エクスポートして編集し、再度インポートしたファイルでは、各アノテーションのコピーが新たに作成されるのではなく、そのアノテーションが更新されます。

読み取れない行があっても、ファイルの処理は停止しません。FitnessSyncer という測定名を指定している行、解析できない日付を含む行、または注釈が空の行はスキップされ、インポート処理の結果として、作成された行数、更新された行数、スキップされた行数、およびそれらの行番号が表示されます。 1,000文字を超える注釈は、拒否されるのではなく、短縮されます。

アプリ内では

FitnessSyncerアプリのiOSおよびAndroidのチャートには注釈が表示されますが、そこでは読み取り専用となっています。書き込みや編集はウェブ上で行ってください。