記錄散佈圖工作流程時,應記下標題、精確的 x,y 列、各自分別有效的無效與超過限制的數量、顯示的座標軸範圍、已檢查的點值,以及下載的 SVG;繪圖時只會解析前 200 列非空白輸入列。
這會建立可重現的紀錄:其他讀者可以看到輸入了什麼、工具接受或略過了什麼、座標軸如何縮放,以及檢查了哪個匯出檔案。在 Scatter Plot Maker 中,預覽與下載內容都來自同一個產生的 SVG 字串,讓螢幕上的結果與獨立的 800 by 500 檔案相互對應。

定義繪圖紀錄必須證明的事項
有用的紀錄應涵蓋你採取的動作與檢查的證據。將來源資料與視覺輸出分開保存:圖表呈現相對位置,而原始列仍是精確數值與後續分析的權威紀錄。
- 目的:說明 x 與 y 代表什麼,必要時包含其單位或意義,並陳述你打算進行的比較。
- 準備:識別來源資料,並記錄貼上之前執行的任何排序、篩選、配對或手動修正。
- 產生:保留標題與提交至工具的各列,以及有效、無效與超過限制的數量。
- 檢查:記錄顯示的座標軸範圍、代表性點值、視覺問題,以及匯出的 SVG 檔名。
| 紀錄 | 應保存的內容 | 所證明的事項 |
|---|---|---|
| 來源 | 精確的 x,y 列與資料來源 | 提交繪圖的內容 |
| 解析器摘要 | 有效、無效與超過限制的數量 | 哪些列已繪製、略過或未解析 |
| 比例檢查 | 各座標軸顯示的最小值與最大值 | 數值如何轉換為位置 |
| 視覺檢查 | 選取的點值與任何重疊情形 | 代表性點是否與來源相符 |
| 輸出 | SVG 檔名與匯出日期 | 交付的是哪個完成品 |
| 限制 | 與比例及詮釋相關的註解 | 圖表能與不能證明的事項 |
準備各列與標題
貼上之前,先準備乾淨的文字版本。每列非空白文字都必須依 x,y 順序包含恰好兩個以逗號分隔的有限數值。可接受帶正負號的值、小數、零與科學記號。不要加入標頭、單位、標籤、額外逗號或空白元件,因為這些列無法通過嚴格的解析器。空白列本身會被忽略,負零則會正規化為零。
將標題保留為一般文字,並把準備好的列貼到相關輸入欄位。如果你的數值位於兩個試算表欄位中,如何從 Excel 欄位製作 2 變數散佈圖指南可協助你將其整理成必要的列格式。不要默默修正遭拒絕的列;保留原始清單,讓你的文件能指出修正了哪些內容。
| 輸入條件 | 工具行為 | 文件註記 |
|---|---|---|
| 前 200 列非空白輸入列中的有效列 | 成為一個藍色圓圈 | 保留對應的來源列 |
| 前 200 列中的格式錯誤列,包括大小超過 1e12 的數值 | 略過並計為無效 | 記錄原因及任何修正 |
| 第 200 列非空白輸入列之後的列 | 計為超過限制且不予解析 | 保留於來源資料中,但不包括在繪製集合內 |
| 空白列 | 忽略 | 不計為有效、無效或超過限制 |
| 整個輸入超過 50,000 個 UTF-16 程式碼單位 | 拒絕 | 嘗試產生之前先減少輸入內容 |
| 沒有任何有效點保留 | 產生程序回報錯誤,並清除任何較舊的圖表 | 修正來源後再次產生 |
建立圖表並擷取每個動作
使用以下順序建立圖表並記錄其精確的產生狀態。
- 保留來源。貼上之前,先保存標題與準備好的各列副本。如果需要重新產生預覽,這份副本就是權威輸入紀錄。
- 檢查列格式。確認每列非空白文字都恰好包含一個逗號,以及依 x,y 順序排列的兩個有效數值。移除標頭與單位,不要讓解析器因此拒絕它們。
- 輸入標題與資料。如需標題便加入,然後貼上各列。如果刻意省略標題,請在圖表日誌中記錄這項選擇。
- 產生圖表。檢查是否成功產生。如果沒有任何有效點保留,請修正來源後再次產生,因為產生失敗時工具會清除較舊的圖表。
- 擷取三項數量。完全依照顯示內容記下有效、無效與超過限制的數字,包括零。不要合併最後兩個類別:無效列已經過檢查並遭拒絕,而超過限制的列則是刻意不予解析。
- 記錄兩個座標軸範圍。從標籤讀取 x 與 y 座標軸顯示的最小值與最大值。不要依圖片估算,並註明零是否位於任一範圍內,因為座標軸不會自動包含零。
- 檢查代表性點。檢視預覽中的數個圓圈,包括接近不同限制值的點。將其標題值與來源列比較,並記下任何重疊或重複座標。
- 匯出已檢查的結果。下載獨立的 SVG,其內容代表預覽中顯示的相同產生結果。記下檔名與匯出日期。編輯標題或資料會清除產生的輸出並停用舊的下載功能,因此任何變更後都要重新產生並重複各項檢查。
檢查比例、常數與重疊
圖表使用彼此獨立的線性比例。最小 x 值會對應至左邊界,最大值則對應至右邊界;最小 y 值會對應至底部,最大值則對應至頂部。中間值依其數值距離按比例定位。請記錄顯示的範圍,而不要將 x 位置描述為等距,因為不等的數值間距在圖表上仍不相等。
- 固定 x 座標軸:當所有 x 值完全相同時,x 領域會以該值為中心對稱擴展,且所有點都會水平置中。
- 固定 y 座標軸:當所有 y 值完全相同時,同樣的擴展規則會獨立套用。
- 擴展大小:新增範圍為該固定值絕對值的 10 percent 或 1 個單位,以較大者為準。因此,單一有效點會顯示為在兩個座標軸上置中,而不會造成除以零的錯誤。
- 重複或接近的配對:標記可能互相遮蔽,尤其是完全相同的配對重複出現時。記錄重疊情形,並使用來源列與點標題值來區分底層座標。
適用時,請在註解中說明固定座標軸的處理方式 Also state that SVG coordinates are rounded to three decimal places and the chart is not a precision-preserving data format; retain the original rows for exact values, uncertainty, and reproducibility.
將圖表與統計主張分開
在同一份文件中定義證據的限制。工具會將提供的配對繪製於線性座標軸上,但不會計算相關性、迴歸、趨勢線、信賴區間、誤差棒、密度、群集或統計顯著性。僅看見某種樣態本身並不構成統計結論。
- 所有解析、版面配置、SVG 建立、預覽準備與下載準備都在目前的瀏覽器本機進行;點與標題不會上傳。
- SVG 為向量輸出,因此縮放時線條、文字與圓圈仍保持清晰。
- 若需要密集資料、分類顏色、無障礙標籤、對數比例、出版樣式或正式統計分析,請使用專用的繪圖套件,並保留來源資料集。
- 圖表的用途是快速視覺檢查。當你的任務需要推論、不確定性估計或正式模型檢查時,請搭配適當的分析方法。
封裝可重複使用的繪圖日誌
可重複使用的日誌應簡潔到容易快速瀏覽,且具體到日後能加以審查。請包含下列加上標籤的欄位:
- 目標:正在進行的比較,以及 x 與 y 的意義。
- 來源:檔案、清單或資料集識別資訊,以及已執行的任何準備工作。
- 精確的產生輸入:提交至工具的標題與完整 x,y 列。
- 摘要:各自分別的有效、無效與超過限制數量。
- 比例驗證:兩個顯示的座標軸範圍,以及任何固定座標軸註記。
- 點驗證:已檢查的代表性點值,以及觀察到的任何重疊情形。
- 匯出:獨立的 SVG 檔名與匯出日期。
- 詮釋限制:相關的統計、精度、密度或樣式限制。
精簡註記可寫成:「使用 [source] 產生 [title];數量:[valid] 個有效、[invalid] 個無效、[over-limit] 個超過限制;顯示範圍:x [minimum] 至 [maximum],y [minimum] 至 [maximum];已檢查 [point values];已匯出 [SVG filename]。」
將該註記與原始資料及匯出檔案存放在一起。如果輸入內容有變更,請建立新版本,不要覆寫舊紀錄,然後重複數量、座標軸、點與匯出檢查。目標是留下比「製作圖表」更有用的紀錄:每個繪製值、略過的列、視覺決策與交付檔案都應能清楚辨識。
如果你正在比較不同選項,如何記錄折線圖產生器工作流程對此有詳細說明。