Skip to content

Latest commit

 

History

History
128 lines (117 loc) · 30 KB

CATALOG.md

File metadata and controls

128 lines (117 loc) · 30 KB

Components / パーツの一覧

Generated by node tools/catalog.mjs from the frontmatter of each components/<name>/README.md. Do not edit by hand. node tools/catalog.mjs が各パーツの README.md の先頭から作る。手で直さない。

パーツ 段 内容の分野 内容 ステップの数 伝えたいこと 見せ方 受け取る値 サンプル
<m-balance> 期待値はつり合いの位置 / Expectation as a balance point 専門(情報・データサイエンス) 数理・統計(academic) 確率の重りを置き、支点が期待値でつり合う様子を示す 数直線と重り→支点を期待値へ→値と和の式(3 ステップ) model — dur, digits, size demo
<m-bars> 標準 標準パーツ(common) 棒をステップごとに 0 から伸ばす(縦棒・横棒・組の棒・積み上げ棒)。値の軸の上限をステップで広げて「軸を突き抜ける伸び」も見せられる 組の step と scale の step の最大(既定は組 1 つ = 1 ステップ。per-step で n 組ずつ) compare, ranking, change, part-whole — orient, max, unit, digits, per-step, dur, stagger, count, ticks, zoom, al, stack, mark demo
<m-boxplot> 専門(統計) 数理・統計(academic) 箱ひげ図。値を並べ、中央値・四分位数を求める手順のとおりに組み立てる。群を並べて比べる steps(既定):点 → 中央値 → 第1・第3四分位数 → 箱 → ひげ。whole:群 1 つ = 1 ステップ spread, compare fade, draw orient, xr, yr, xt, yt, xf, yf, xl, yl, method, outliers, dots, build, unit, digits, dur demo
<m-callout> 画面の手順 / Screen steps 専門(ツール) 標準パーツ(common) 画面の画像に番号の丸を置き、引き出し線で横の説明につなぐ。ステップごとに 1 つずつ(研修・手引き・操作の説明) 説明の step の最大(既定は説明 1 つ = 1 ステップ。per-step で n 個ずつ) process — side, label-width, per-step, dur, size demo
<m-cards> 標準 標準パーツ(common) カード(番号の丸・アイコン・見出し・説明)を横一列か 2 段に並べ、ステップごとに出す。矢印で順を、枠の色で強調を見せる カードの step の最大(既定はカード 1 枚 = 1 ステップ。per-step で n 枚ずつ) process, grouping rise, fade, draw layout, arrows, nums, hilite, per-step, stagger, dur demo
<m-checklist> 確かめる一覧 / Checklist 専門(ツール) 標準パーツ(common) 確かめる項目を並べ、ステップごとに 1 つずつ印(✓・×)を描く。印はスライドの中身で、見ている人の操作を保存しない 項目の step の最大(既定は項目 1 つ = 1 ステップ。per-step で n 個ずつ) process — reveal, per-step, dur, stagger, size demo
<m-ci> 信頼区間の意味 / Confidence intervals 専門(情報・データサイエンス) 数理・統計(academic) 正規標本の区間を重ね、母平均を含む割合で信頼水準を説明する 軸と μ→区間を順に→含む数と外れの強調(3 ステップ) model, spread — dur, fast, size demo
<m-code> コードの解説 / Code walkthrough 専門(情報・データサイエンス) 数理・統計(academic) 短いコードを行ごとに説明し、最後に出力を見せる コード全体→説明を順に→出力(説明数+1、出力ありは+2) process, model — dur, size, outputPos demo
<m-codetree> ハフマン木 / Huffman tree 特殊 情報(info) ハフマン木で 2 値の系列を 1 語ずつ復号する(MH 符号)。ランは画素の升目に伸びる 符号語の数 + まとめの 1(summary="false" なら足さない)。表にない符号か、符号の途中で終わる系列なら、その誤りに +1。bits が空なら 0 hierarchy, process — bits, depth, bit, move, fill, summary, mark, window demo
<m-collect> 特殊 数理・統計(academic) 並んだ札(回答など)が動いて縮み、少数の箱(要約)にまとまる 1 grouping — move, stagger, shrink, chip-w, chip-h, box-w, box-h demo
<m-compare> 標準 標準パーツ(common) 2 つ(3 つまで)を横に並べて比べる表。一方の列、もう一方の列、それから行ごとの違い 列の数 + 1(違いのステップ。diff も better もなければ列の数だけ) compare fade, slide, reveal size, dur, diff-label demo
<m-curves> 標準 標準パーツ(common) 同じ座標軸に線を 1 本ずつ引く(線の名前は凡例でなく線の端に直接書く) step の最大(既定は系列の数) change — xr, yr, xt, yt, xf, yf, xl, yl, n, dur, lw, size demo
<m-cycle> 標準 標準パーツ(common) 循環の図。項目の箱を円の上に 12 時から時計回りに並べ、円に沿った矢印でつなぐ(最後から最初へ戻る矢印も) ステップの数(既定は 1 つ = 1 ステップ。per-step で n 個ずつ、node の step が優先) cycle fade, draw, grow per-step, size, dur, stagger demo
<m-diverge> ウォーターフォール / Waterfall 専門(ビジネス) ビジネス(business) 基準の棒から始め、増減の棒を前の棒の端から上下に積んで、最後に合計の棒を立てる(ウォーターフォール) 棒の step の最大(既定は棒 1 本 = 1 ステップ。per-step で n 本ずつ) deviation, compare — unit, digits, per-step, dur, stagger, min, ticks, links, al demo
<m-fishbone> 標準 標準パーツ(common) 原因と結果の図(特性要因図・フィッシュボーン図)を、大骨 1 本ずつ組み立て、最後に結果(頭)を出す。座標は書かず、配置はパーツが決める 大骨の数 + 1(頭)。節と edges の step があればその最大 cause-effect fade, draw, grow order, size, fade, draw demo
<m-flow> 標準 標準パーツ(common) 流れ図の箱と矢印をステップごとに出して、図を組み立てる nodes と edges の step の最大 process — fade, draw, size, pulse-dur, pulse-n, label-gap demo
<m-folds> 交差検証 / Cross-validation 専門(情報・データサイエンス) 数理・統計(academic) 検証用の区画を順に替え、各分割の誤差と平均を示す 分割を 1 行ずつ→平均(k + 1 ステップ) model, compare — dur, size demo
<m-gendai> 専門(国語) 国語(kokugo) 現代文の読解の図:傍線・二重傍線を引き、指示語から指す内容へ矢印、段落を役割(主張・具体例・対比)の枠で囲んで線でつなぐ 中身のある phases の数(既定 marks refs roles) text-structure — size, tate, phases, draw demo
<m-heatmap> 専門(統計) 数理・統計(academic) ヒートマップ。値で塗ったセルの格子(混同行列・相関行列・注意の重み) rows:行を 1 つずつ(normalize="row" の既定)。whole:全体を 1 ステップ。cells:全体、それから強調を 1 つずつ(highlight があるときの既定) compare, correlation fade, sweep scale, center, range, tone, lowtone, normalize, show, numbers, diag, build, rotate, xl, yl, unit, digits, dur demo
<m-hissan> 専門(数学) 数理・統計(academic) 筆算(たし算・ひき算・かけ算・わり算、小数も)。式を書けば、パーツが教科書の手順で計算して書く +−は位ごと、×は 1 段ごと(fine で 1 けたずつ)→たす、÷は商 1 けたごと(per="phase" で たてる・かける・ひく・おろす ごと) process fade, draw expr, build, fine, per, kari, rem, digits, carry, words, focus, dur demo
<m-hist> 専門(統計) 数理・統計(academic) ヒストグラム・度数折れ線・ドットプロット。平均値・中央値・最頻値の線も 分布(系列 1 つ = 1 ステップ)→ 度数折れ線 → 代表値を 1 つずつ spread fade, grow xr, yr, xt, yt, xf, yf, xl, yl, unit, digits, polygon, relative, cumulative, kind, marks, build, dur demo
<m-kakijun> 特殊 国語(kokugo) かな(ひらがな・カタカナ)の書き順。字を 1 画ずつ、書く順と向きのとおりに書いて見せる 字 1 つ=1 ステップ(ステップの中で 1 画ずつ)。per="stroke" なら 1 画=1 ステップ process draw, pen text, per, writing, grid, ghost, nums, ends, size, dur demo
<m-kanbun> 専門(国語) 国語(kokugo) 白文に返り点・送り仮名を付け、訓読の順に字をたどり(返り点で上へ戻るところに弧)、書き下し文にする(縦書き) phases の数(order は句の数だけ、order-by="all" なら 1。既定:訓点 1+句の数+書き下し文 1) text-structure — size, slot, phases, kaki, nums, order-by demo
<m-keyboard> 専門(音楽) 音楽(music) ピアノの鍵盤。音階・和音・半音と全音を光らせて音も鳴らす steps の 1 つ = 1 ステップ(鍵盤は t でずらして順に光る) music light, press, rise (なし。子の JSON) demo
<m-kobun> 「操作できる」 専門(国語) 国語(kokugo) 古文を語に切り(スラッシュ)、品詞で色を分けて 1 文ずつ見せ、最後に現代語訳と並べる。助動詞を押すと活用表と意味 文の数(現代語訳があれば +1) text-structure — size, tate, yaku, fade, detail demo
<m-kpi> 標準 標準パーツ(common) 大きな数字の札(KPI)をステップごとに出す。数字は数え上げ、下に増減の矢印と一言 札の step の最大(既定は札 1 枚 = 1 ステップ。per-step で n 枚ずつ) key-number count, rise, flip, underline cols, digits, per-step, dur, stagger, count, size demo
<m-map-japan> 専門(地図) 地図(社会)(social) 日本の 47 都道府県の地図。地域の強調、統計の塗り分け、点、矢印、経度・緯度の重ね描きをステップごとに出す 項目の step の最大(既定 1)。地図そのものはステップ 0 から出ている spatial fade, sweep, draw layout, islands, labels, show, unit, digits, legend, dur demo
<m-map-world> 専門(地図) 地図(社会)(social) 世界の国・地域の地図(太平洋が中央)。国や州の強調、区分と値の塗り分け、点、矢印をステップごとに出す 項目の step の最大(既定 1)。地図そのものはステップ 0 から出ている spatial fade, sweep, draw labels, grid, show, unit, digits, legend, dur demo
<m-mapping> 確率変数の対応 / Random variable mapping 専門(情報・データサイエンス) 数理・統計(academic) 実験の結果を数値へ対応させ、同じ値になる結果をまとめて確率分布を作る 結果の札→対応の矢印→同じ値の色と個数・確率の和→分布の横棒の 4 ステップ model, grouping — dur, stagger, digits, size demo
<m-market> 専門(ビジネス) ビジネス(business) 市場規模の入れ子の円(TAM / SAM / SOM)。外の円から 1 つずつ、前の円の大きさから縮んで現れる rings の数 part-whole — unit, digits, scale, layout, dur, count demo
<m-menu> 「操作できる」 標準 標準パーツ(common) スライドへのリンクの札を格子に並べる(目次・単元の選び方)。札はふつうの 、行ったスライドの札に「見た」の印 ceil(札の数 / per-step)(既定の per-step="0" なら 0:初めから全部) contents — cols, per-step, size, fade, stagger, visited demo
<m-numberline> 専門(数学) 数理・統計(academic) 数直線。点・□・ジャンプ・不等式の範囲・0.1 の拡大。2 本で比例数直線 build の順(既定 ticks,marks,links,jumps,ranges,magnify)に項目 1 つ = 1 ステップ。whole:全部で 1 ステップ compare fade, draw build, arrow, dur demo
<m-orbit> 専門(理科) 数理・統計(academic) 月の満ち欠け(金星の満ち欠け)。北極の上から見た図と地球から見た形を並べ、月を位置から位置へ動かす。形は位置から計算する 動く先の数(既定は 8 つの位置を新月から 1 周 = 8 ステップ。visit で決める) model, cycle — mode, hemisphere, sun, earth, moon, observer, size, dur demo
<m-particles> 粒子のモデル / Particle model 専門(理科) 数理・統計(academic) 状態変化の粒子の並び方と間隔、化学変化で保存される原子の数を見せる state は states の数 − 1(既定 2)。reaction は反応前→原子に分かれる→反応後の 3 ステップ model, process, compare — mode, count, size, dur, volume, motion demo
<m-pie> 標準 標準パーツ(common) 円グラフとドーナツグラフ。切れの名前と値・割合は、大きい切れなら中に、小さい切れなら外に引き出し線で書く 既定は 1(全部を一度に)。per-step で n 切れずつ、切れの step で直接 part-whole fade, sweep, grow donut, unit, digits, pct-digits, show, per-step, dur demo
<m-predict> 「操作できる」 標準 標準パーツ(common) 予想してから答えを開く。選択肢ごとの人数を棒で見せ、答えのステップで正解に枠(入力あり) 0 問いと選択肢、1 人数の棒、answer-step(既定 2)で答え predict fade, draw answer-step, unit, poll, ticks demo
<m-quad> 標準 標準パーツ(common) 2 軸の位置づけ(ポジショニングマップ・SWOT 風の 4 象限)に、点をステップごとに 1 つずつ置く 点の step と to.step の最大(既定は点 1 つ = 1 ステップ) position — fade, move, size, quads-step demo
<m-sampling> 標本抽出 / Sampling 専門(情報・データサイエンス) 数理・統計(academic) 母集団から標本を取り、比率・平均の標本分布を積む 母集団→抽出→統計量と点→反復の 4 ステップ model, spread — dur, stagger, fast, size demo
<m-scatter> 標準 標準パーツ(common) 散布図。点の組(系列)をステップごとに出し、そのあと傾向の線(最小二乗の直線か、書いた 2 点)を引く 系列の数 + 傾向の線(既定は系列 1 つ = 1 ステップ、そのあと線をまとめて 1 ステップ。系列・線の step で直接) correlation fade, sweep, grow xr, yr, xt, yt, xf, yf, xl, yl, r, dur demo
<m-score> 専門(音楽) 音楽(music) 楽譜(五線譜)を 1 音・和音ずつ、または 1 小節ずつ出して音も鳴らす。ABC 記譜法で書く 音符・和音・休符 1 つ=1 ステップ。by="measure" なら 1 小節=1 ステップ(per-step="N" なら N 小節。弱起の小節は次のステップに入る) music light by, names, per-step demo
<m-seq> 専門(統計) 数理・統計(academic) 観測を 1 つずつ加え、分布と数値が更新されていく様子を見せる(前の分布は薄く残す) ceil((steps の数 − 1) / per-step) spread — per-step, slot, xr, yr, xt, yt, xf, yf, xl, yl, digits, panel, ghosts demo
<m-sweep> 専門(数学) 数理・統計(academic) パラメータを動かして関数の形の変化を見せる(前の形は灰色で残す) values の数 − 1(at があれば 1) parameter — f, values, param, xr, yr, xt, yt, xl, yl, digits, dur, at, point, size demo
<m-syntax> 専門(英語) 英語(english) 英文の構造:S V O C M の記号、句と節の括弧、修飾の矢印、品詞、それから和訳 出てくる要素(S V O C M)を 1 つずつ+括弧・矢印・和訳(あるものだけ)。build="whole" で 1 text-structure fade, draw size, pos, build, yaku demo
<m-tape> 専門(数学) 数理・統計(academic) テープ図・線分図。全体や部分を括弧で括り、わからない量は □ か ?。行から行へ「2 倍」の矢印 steps(既定):行 → 括弧 → 倍の矢印を 1 つずつ。rows:行 1 つ = 1 ステップ。whole:全部で 1 ステップ part-whole, compare fade, grow kind, build, dur demo
<m-timeline> 標準 標準パーツ(common) 年表。出来事を時間の軸の上に 1 つずつ出す。期間は帯にして、重なる期間は段を分けて積む。end は含まない("1912" は 1912 年の初め) 出来事の数(既定は時刻の順に 1 つ = 1 ステップ。per-step で n 個ずつ、node の step が優先) timeline fade, draw, grow orient, scale, per-step, size, dur, stagger, unit, today demo
<m-timer> 「操作できる」 「ツール」 専門(ツール) 標準パーツ(common) グループワークの進行タイマー。区切りごとに残り時間を大きく数え、区切りの一覧で今の区切りを示す(入力あり) 0 準備の画面、区切り 1 つが 1 ステップ(その長さ = sec 秒) timebox fade (なし) demo
<m-tree> 標準 標準パーツ(common) 階層・分類の木(組織図、生物の分類など)を、根から 1 段ずつ組み立てる。座標は書かず、配置はパーツが決める 節の深さの数(by="level"、既定)か節の数(by="node")。節と edges の step があればその最大 hierarchy fade, draw, grow orient, by, link, size, fade, draw demo
<m-venn> 標準 標準パーツ(common) 2 つか 3 つの集合の円(ベン図)。集合を 1 つずつ出し、最後に重なりを強めてその中の項目を出す 集合の数 + 1(overlaps="each" なら 集合の数 + 項目のある重なりの数。項目のある重なりがなければ重なりすべての数:2 集合で 1、3 集合で 4) overlap fade, draw size, dur, spread, overlaps demo

By tier / 段から

Standard (標準): offered for every lesson. Specialized (専門): offered by set when the scene or the title calls for it. Extra (特殊): not offered; used when a lesson clearly needs one (read its README). The set is how specialized parts are loaded and evaluated together. 標準はどの教材にも出す道具。専門は場面やタイトルから束ごとにすすめる。特殊は一覧に出さず、材料がはっきり要るときに README を読んで使う。

段 束 パーツ
標準 — <m-bars> <m-cards> <m-compare> <m-curves> <m-cycle> <m-fishbone> <m-flow> <m-kpi> <m-menu> <m-pie> <m-predict> <m-quad> <m-scatter> <m-timeline> <m-tree> <m-venn>
専門 統計 <m-boxplot> <m-heatmap> <m-hist> <m-seq>
専門 情報・データサイエンス <m-balance>(期待値はつり合いの位置 / Expectation as a balance point) <m-ci>(信頼区間の意味 / Confidence intervals) <m-code>(コードの解説 / Code walkthrough) <m-folds>(交差検証 / Cross-validation) <m-mapping>(確率変数の対応 / Random variable mapping) <m-sampling>(標本抽出 / Sampling)
専門 数学 <m-hissan> <m-numberline> <m-sweep> <m-tape>
専門 理科 <m-orbit> <m-particles>(粒子のモデル / Particle model)
専門 地図 <m-map-japan> <m-map-world>
専門 国語 <m-gendai> <m-kanbun> <m-kobun>
専門 英語 <m-syntax>
専門 音楽 <m-keyboard> <m-score>
専門 ビジネス <m-diverge>(ウォーターフォール / Waterfall) <m-market>
専門 ツール <m-callout>(画面の手順 / Screen steps) <m-checklist>(確かめる一覧 / Checklist) <m-timer>
特殊 — <m-codetree>(ハフマン木 / Huffman tree) <m-collect> <m-kakijun>

Library parts / ライブラリのパーツ

Components 2.0 (alpha, not for lessons yet): parts other parts require (Egatari spec §6.1). They define no element and are not written by authors. 2.0 の準備中(まだ教材には使わない)。ほかのパーツが使うパーツ。要素を作らず、作者が直接は書かない。

パーツ バージョン 内容 使うパーツ
base 1.2.0 2.0 の要素のパーツが使う土台(基底のクラス MotionElement と、SVG・時間・見せ方の補助)。データの形は mount の前に確かめる。教材の作者が直接は書かない shape@1.0.0
boxplot-core 1.0.0 m-boxplot の四分位数の計算(中央値、教科書の求め方 jp と表計算の inc・exc の四分位数、1.5×四分位範囲の外れ値)。教材の作者が直接は書かない —
codetree-core 1.0.0 符号表からハフマン木を作り、2 値の系列を復号する(ファクシミリの MH 符号:白と黒のランを交互に読む)。m-codetree が使う。教材の作者が直接は書かない —
expr 1.0.0 2.0 のパーツが属性やデータに書かれた式を計算するための、算術だけの安全な式の評価器(コードとしては動かさない)。教材の作者が直接は書かない —
heatmap-core 1.0.0 m-heatmap の計算(行ごとの割合、色の範囲と混ぜる割合、セルの字の色と縁、名前の間引きとセルの大きさ、ステップ)。教材の作者が直接は書かない —
hist-core 1.0.0 m-hist の代表値と度数の計算(平均値・中央値・最頻値、階級への数え上げ、度数分布表からの代表値)。教材の作者が直接は書かない —
icons 1.0.0 名前で引く線のアイコン(Tabler Icons outline 3.49.0、MIT、4,808 個。brand-* と塗りのアイコンは入れない)。教材の作者が直接は書かない —
kanbun-core 1.0.0 漢文の読み取り(白文・返り点・送り仮名・振り仮名)と訓読の順・書き下し文の計算。m-kanbun が使う。教材の作者が直接は書かない —
markup-reader 1.0.2 組み立てのときに描いた結果(KaTeX の HTML・MathML、abcjs の SVG)を、決まった要素と属性だけで読んで置く。教材の作者が直接は書かない base@1.2.0
plot 1.1.2 2.0 のパーツが使う座標軸つきの図(軸・目盛り・軸の名前・切り抜き)。教材の作者が直接は書かない base@1.2.0
shape 1.0.0 2.0 のパーツのデータの形(static shape)を確かめる小さなライブラリ。base が使う。教材の作者が直接は書かない —

By purpose / 伝えたいことから

From purposes.json (docs/conventions.md §4). Bold: the component's main purpose. Reserved: no component yet. purposes.json から作る。太字はそのパーツの主な伝えたいこと。予約は、まだパーツのないもの。

id 伝えたいこと Purpose 既定のステップ パーツ
compare 比べる(量・特徴) Compare (amounts or features) 一方を出し、それから違い <m-bars> <m-boxplot> <m-compare> <m-diverge> <m-folds> <m-heatmap> <m-numberline> <m-particles> <m-tape>
ranking 順位 Ranking 並べ替えた棒を 1 本ずつ <m-bars>
change 時間での変化 Change over time 線を 1 本ずつ <m-bars> <m-curves>
part-whole 全体と内訳 Part of a whole 一度に全部 <m-bars> <m-market> <m-pie> <m-tape>
key-number 1 つの大事な数字 One key number 一度に全部 <m-kpi>
process 手順・工程 Steps of a process 1 つの手順ずつ <m-callout> <m-cards> <m-checklist> <m-code> <m-codetree> <m-flow> <m-hissan> <m-kakijun> <m-particles>
timeline 年表・予定 Timeline, schedule 1 つの出来事ずつ <m-timeline>
cause-effect 原因と結果 Cause and effect 原因、それから結果 <m-fishbone>
cycle 循環 Cycle 順を追って 1 つずつ <m-cycle> <m-orbit>
hierarchy 階層・分類 Hierarchy, classification 上から <m-codetree> <m-tree>
position 位置づけ(2 軸) Position on 2 axes 軸、それから項目 <m-quad>
overlap 重なり Overlap 集合、それから重なり <m-venn>
correlation 2 つの量の関係 Two quantities 点、それから傾向 <m-heatmap> <m-scatter>
spread ばらつき Spread 一度に全部 <m-boxplot> <m-ci> <m-hist> <m-sampling> <m-seq>
grouping まとめる・分ける Grouping まとまる動き <m-cards> <m-collect> <m-mapping>
text-structure 文章の構造 Structure of a text 読む順 <m-gendai> <m-kanbun> <m-kobun> <m-syntax>
contents 目次 Contents 一度に全部 <m-menu>
parameter パラメータを動かす Varying a parameter 値を 1 つずつ <m-sweep>
predict 予想してから確かめる Predict, then check 問いと選択肢、それから答え <m-predict>
timebox 時間を区切る Time-boxing 区切りを 1 つずつ(残り時間) <m-timer>
spatial 場所・地図 Place / map 地図、それから地域・点・矢印を 1 つずつ <m-map-japan> <m-map-world>
music 音楽(音の高さ・和音・リズム) Music (pitch, chords, rhythm) 音・和音を 1 つずつ <m-keyboard> <m-score>
model 仕組みをモデルで見る How it works (a model) 全体、それから動きを 1 つずつ <m-balance> <m-ci> <m-code> <m-folds> <m-mapping> <m-orbit> <m-particles> <m-sampling>
deviation 差・増減 Deviation, increase and decrease 基準、それから差 <m-diverge>
concept-links 概念のつながり Concept links 中心から外へ (予約 / reserved)