Matplotlib 透過 plt.bar(x, height) 把一組類別標籤與數值清單轉成垂直長條圖,但只要把 2 到 30 筆嚴格的「標籤,數值」列貼進 Bar Chart Maker,再把預覽匯出成獨立的 SVG,就能不寫 Python 達到相同結果。這個瀏覽器工具把 import 陳述式、figure 呼叫與 savefig 那一行全部換成一顆 Generate 按鈕,接著產生一張 520 像素高的 SVG,採用固定的線性 y 軸、零基準線,以及五個等距的參考刻度。大多數搜尋 matplotlib 教學的人通常只想要三件事:把小型資料集快速變成看得到的圖、能夠預測地掌控長條與軸刻度的外觀,以及一個可以放進簡報、文件或網頁的可攜檔案。這個瀏覽器工具三項都能涵蓋,但有一個值得先說在前的取捨:它刻意做得很窄,只接受精簡版 CSV 列而非完整 CSV、只使用固定線性刻度而非 matplotlib 可選的對數刻度,並且完全在當前分頁中執行,而非透過 Python 直譯器執行。同一個匯出檔案同時驅動可見的預覽與 Blob 下載,因此你看到的內容就是實際存下的檔案。本文接下來會逐步說明這個工具接受什麼輸入、計算什麼內容,以及如何在下載前驗證 SVG。

how to make bar chart in matplotlib
how to make bar chart in matplotlib

matplotlib 對這份資料會畫出什麼

小型類別資料集的 matplotlib 路線大致如下。假設你有五個水果類別,銷售數量分別是 73、45、60、28 與 12。在典型的 matplotlib 腳本中,你會建立兩個平行的清單、呼叫 plt.bar(labels, values)、選擇性地用 ax.set_title(...) 加入標題,再用 plt.savefig("fruit_sales.svg") 存檔。預設行為會給你五條垂直長條、線性 y 軸、零基準線,以及數量不多的幾個參考刻度,其精確位置由 matplotlib 內部決定。輸出是可攜的,但你仍然需要一個可運作的 Python 環境、安裝好的 matplotlib 套件,以及足夠的上下文切換,才能讓腳本、資料與圖檔保持同步。

基於瀏覽器的 Bar Chart Maker 從相反的方向抵達同一個目的地。貼上資料、點擊一次,預覽就會顯示 matplotlib 本來會畫出的內容:五條垂直長條、零基準線、五個參考刻度、可選的標題,以及每條長條下方一個旋轉過的類別標籤。圖表高度固定為 520 像素;寬度則隨著類別增加而變大,當 30 個標籤會被擠進狹窄螢幕時,預覽會水平捲動。

瀏覽器工具強制執行的輸入規則

因為這個工具刻意做得很窄,每一筆輸入都必須遵循嚴格格式。可接受的格式是「label,value」——一個標籤、一個逗號、一個數值標記——至少兩列、最多三十列,且每一列都不能是空白。空白或僅含空白的行會被忽略。標籤最多 24 個 UTF-16 字碼單元,數值標記最多 40 個。任何一邊只要超過限制 1 個字碼單元,整個請求就會失敗。解析器絕不會默默只保留前 30 列、跳過錯誤列、把缺失值代換成零,或回傳部分圖表。

在數值方面,只接受非負的有限十進位數字。像是 12.75 這類一般小數,以及 1.2e3 這類科學記號都允許。負零會被正規化成零。詞法上溢位為零的輸入、超過 1e300 的輸入、十六進位、Infinity、NaN、運算式、加上單位的數字、加上引號的欄位、額外的欄位,以及空標籤,全部會被拒絕。重複的標籤在輸入順序中仍然是各自獨立的長條;這個工具不做彙總、排序或單位推斷。每個標籤與數字前後的空白會自動被修剪掉。

範例輸入結果
Apples, 73Accepted
Bananas,12Accepted (whitespace trimmed)
Oranges, 1.2e2Accepted (scientific notation)
Grapes, -5Rejected (negative value)
Plums, NaNRejected (not a finite number)
"Fuji, Red", 8Rejected (quoted field)
Pears, 45, 60Rejected (two commas)
,73Rejected (empty label)
blank lineIgnored

不寫 Python 也畫出同一張圖

  1. 輸入可選的標題,並把 2 到 30 筆嚴格的「標籤,數值」列貼進輸入區。每個非空列只能有一個逗號,左邊是標籤,右邊是一個非負的有限數字。
  2. 點擊 Generate 並檢查預覽。確認類別標籤讀起來正確、五個參考刻度完整呈現整個範圍、基準線落在零的位置,以及沒有任何長條因為極端的數值範圍而細到看不見。
  3. 點擊 Download SVG 來存檔。下載的字串與預覽中顯示的標記完全相同,檔案是一個帶有 W3C 命名空間的獨立 SVG,而解析、版面配置、預覽與下載全都留在當前瀏覽器分頁中執行。

編輯標題或資料會立刻清掉先前的預覽、狀態訊息與下載連結,因此舊的圖表絕不會洩漏到新的輸出中。下載的 SVG 可以直接用瀏覽器開啟、放進簡報,或貼進 HTML——它不依賴任何外部樣式表或腳本。

線性刻度與參考刻度是如何決定的

Bar Chart Maker 採用的是決定性的、由產品定義的「整齊範圍」做法,而不是重現 matplotlib 的內部刻度演算法。長條高度等於數值乘上繪圖高度再除以顯示的座標軸最大值,因此資料集裡最大的數值決定最上方的刻度位置。顯示的最大值會無條件進位到下一個嚴格大於最大值的 1、2、5 或 10 倍十的冪次有限倍數。接著由五個等距的參考刻度呈現這個範圍。

舉個具體例子,假設資料集的最大值是 73。73 落在 [10, 100) 這個區間,所以參考的十的冪次是 10² = 100。100 的 1/2/5/10 倍數分別是 100、200、500 與 1000。第一個嚴格大於 73 的倍數是 100,因此顯示的座標軸最大值變成 100。五個參考刻度依序是 0、25、50、75 與 100。一個數值為 25 的長條因此恰好達到繪圖高度的四分之一。座標會四捨五入到小數點後三位再寫進標記,而軸標籤在範圍需要時最多使用六個有效數字,或改用科學記號。

當資料集裡每個數值都是零時,圖表會切換到明確的零到一參考範圍,讓所有長條維持在基準線上的零高度,並加上「全部為零」的註記。這樣既能避免除以零的錯誤,又不會改動使用者提供的數值。

matplotlib 處理方式不同的邊界情況

有三種行為值得注意,因為它們和典型的 matplotlib 預設執行結果並不相同。

  • 極端的數值範圍。當某個類別的數值比其他類別大上數百個數量級時,較小長條的像素高度可能低於 SVG 的座標精度而看起來消失。工具提示仍會回報實際數值,但若需要讓小型類別在視覺上仍可區隔,應該改用對數刻度或額外分組的圖表。
  • 負值或非有限值。解析器會直接拒絕整個資料集,而非跳過錯誤列,因此單一筆的打錯字就會停止產生。這比 matplotlib 更嚴格,後者會默默為負值畫一條向下的長條。
  • 沒有對數刻度,也沒有百分比正規化。這個工具不會切換到對數刻度、不會把長條正規化成佔總體的百分比,也不會暗示統計顯著性。如果觀眾需要比較佔全體的比例,圓餅圖會是更合適的選擇。

matplotlib vs. Bar Chart Maker 一覽

面向matplotlibBar Chart Maker
RuntimePython interpreter with matplotlib installedCurrent browser tab, no installation
Input shapeLists, arrays, or pandas DataFrames2 to 30 strict label,value rows
Scale typeLinear or logarithmicLinear only
Tick computationmatplotlib internal algorithm1/2/5/10 nice upper bound, five fixed ticks
Output formatsPNG, PDF, SVG, and othersStandalone SVG only
Data uploadStays local unless explicitly saved onlineNever leaves the browser tab
Code requiredYesNo

對 matplotlib 使用者來說,實際的決策點在於:資料集是否小到(2 到 30 個類別)且夠「乖」(非負有限值、標籤中不含逗號),足以套進這個瀏覽器工具的嚴格格式。如果可以,瀏覽器路線就能把 import 陳述式、figure 呼叫、savefig 那一行與一次終端機執行,換成三次點擊。

下載前驗證 SVG

驅動預覽的那段單一字串就是最後變成下載 Blob 的那段字串,所以你看過的圖表就是實際收到的圖表。檔案採用 W3C SVG 命名空間,並使用標準的 rect、line、text、g 與 title 元素,因此能在現代瀏覽器、設計工具,以及接受 SVG 的文件編輯器中正確呈現。使用者輸入的字串會在進入文字、工具提示、標題或無障礙屬性前先做 XML 跳脫——&、角括號、引號與撇號都會變成實體,而 XML 不允許的控制字元會變成 U+FFFD。因此,長得像腳本的標籤會保持為可見文字,而不會變成 SVG 元素。

座標一律由通過驗證的有限數值產生,並四捨五入到小數點後三位,因此標記裡不可能出現超出範圍或非有限的座標。即使可見標題是空白的,仍會帶有「Bar chart」這個無障礙標籤,讓輸出對螢幕閱讀器保持友善。當標題或資料被編輯、結果被取代、產生過程發生錯誤,或元件卸載時,Blob URL 就會被撤銷,因此無論是立即撤銷導致的下載競爭,或是持續累積的 ObjectURL 洩漏都不會發生。如需底層標記的權威參考,請參閱 W3C SVG 2 規格;如需這個工具所模擬的線性刻度類型,請參閱 D3 線性刻度說明文件。

如果你正在比較各種選項,How to Make a Pie Chart in PowerPoint in 3 Steps 對此有詳細說明。

如果你正在比較各種選項,Generate Random Letters in Python Without Writing Code 對此有詳細說明。