獲取矢量圖
如果這篇paper在arXiv上發布而且使用LaTeX等工具排版，在arXiv上點擊“other formats”，應該有文章的源代碼（source）：
圖片截取自
如果是LaTeX源代碼，一般是.tar.gz格式，按照這個格式打開應該就能找到原始的矢量圖（如pdf）圖片文件。如果找不到矢量圖，直接用pdf格式的文章文件，把圖片所在頁拿出來處理應該也可以，不過可能有更多干擾。這個教程里，我們使用示例圖片，可以在這里下載：
這個圖長這樣（其實就是我隨手畫的圖）：
例如用vector-plot-從上圖的下面一個panel提取數據，操作界面如下圖。最終我們能得到的數據復原出來原始的圖如下圖右側。Awesome!
操作教程
現在開始詳細的操作步驟教程。
假如需要處理的圖片地址是“example.pdf”，則在終端輸入（你應該把“example.pdf”替換成這個文件的完整路徑，或者先通過 “cd path/to/your/file” 把所在目錄移動到文件所在目錄）：
vpextract example.pdf文件順利打開后，會在“example.pdf”所在的相同目錄中生成一個“example.pdf.drw”文件（“example.pdf”替換成你實際讀入的文件名）。
第一步需要告訴程序圖中不同的元素都是什么，例如是折線還是散點圖。
程序會產生如下窗口：
點擊任意圖中的元素就會在右上角將其顯示出來。例如試圖點擊圖中紅線，進入如下界面（注意提示語顯示在figure上方標題處）：
在這種界面中，如果有大寫字母在方括號中間，表示用鍵盤輸入這一字母（小寫，目前不接受用鍵盤輸入大寫字母）可以執行這個字母所在詞/詞組的操作。現在發現右上角顯示出來是白色（什么都看不出來），這是因為圖片中經常會有白色矩形，現在點上的是一個這樣的白色矩形。這些元素沒有什么用處，應該將它們去掉。遇到這種用鍵盤按“d”表示這一個元素要去除，界面變成下圖：
現在可以選擇匹配圖形中所有形狀/顏色/形狀和顏色與所選元素相同的元素，將其標記為相同的類型（這里是“discard”）。我們按“o”，把所有顏色相同（白色）的元素都標為需要去除。此時界面變為：
按任意鍵繼續，回到這一界面：
此時點擊紅色線（如果點擊任意元素后標題中文字沒有任何變化，說明沒點上，可以用窗口中的放大鏡圖標把圖放大后再點；這個窗口上方幾個按鈕的功能可自行嘗試）：
這里每個元素有4種標記，scatter表示散點，line表示折線，discard表示這是沒用的元素可直接刪除，others表示這是其他有用的圖形（比如陰影圖）。這個紅線是一根折線，按“l”即可：
因為圖中所有這種紅色都是線，可以按“o”把所有線匹配上。此時右下角會顯示從匹配上的所有紅線，所有這些將被標記為“線”（line）。按任意鍵繼續后，紅線從左圖消失，減少干擾：
現在再在左圖點擊藍點：
此時右上角顯示的大圖就是一個散點（一個點是用藍色正方形標記的）。按“s”把這個點標記為散點（scatter）：
這種小方塊都是散點，按s, o, l中任意一個應該都能很好地匹配到所有這樣的散點：
可以看到，從圖中匹配到了60個這樣的點。按任意鍵繼續，類似地把所有需要提取數據的元素（line/scatter/other）或者需要刪除的元素（discard）都標記上。坐標軸刻度等元素不要標記。最后剩下一個這樣的界面：
此時所有需要標記的元素都已經標記完成，按“f”結束操作。
此時第一步結束，在“example.pdf”所在目錄下會多出“example.pdf.typ”和“example.pdf.mkr”文件。這兩個文件記錄了你在第一步操作的結果。這樣你可以中途結束程序，再次運行時可以不再重復第一步。如果你再次運行“ example.pdf”，會提示是否重做第一步（重做意味著如果你不備份這兩個文件，你以前的操作會完全丟失）。如果不重做，會直接讀取這兩個文件的內容。提示是否重做會像這樣：
y/[n]的意思是默認為n（no）。輸入“y”會重做第一步，否則輸入任何內容都不會重做這一步。
現在進入第二步，此時會再次彈出一個窗口：
在這一步中，你可以選擇過濾掉一部分圖中的元素。目前只支持一種選擇模式：在圖中按住鼠標拖動可以產生一個矩形。所有經過矩形內部的元素會被選中。選中的元素被保留，其他元素均被去除。因為第一步中你已經告訴了程序什么是散點，這次程序會嘗試自動把一組散點當成一個元素。例如，圖中散點組成的一條線也應該當作一個元素。因此，假如我們像下圖一樣選擇，那么整個一組散點都會被選中：
在這個例子中，我們不需要過濾掉圖中更多的元素了。所以按“r”重設：
因為我們不需要過濾掉任何元素，所以第二步實際上我們可以不做任何操作，直接關閉這個窗口即可。
此時第二步結束，會多出一個“example.pdf.sel.obj”文件，這里包含已經過濾過的圖中元素。類似地，以后再次運行時，可以直接讀取這個文件，而不再需要重做第二步。
最后進入第三步，終于可以提取數據了。此時會彈出如下窗口：
此時左圖是經過第二步過濾以后的矢量圖，左下角是可以編輯的文本框（textbox）。要想提取數據，需要添加一個坐標軸（axis）。可以按任意一個數字鍵（比如0）進入到這一編號（比如第0號）的坐標軸中。即使不存在這個坐標軸（初始條件下沒有任何坐標軸），按住數字鍵的狀態下你也可以看到所有現有的坐標軸編號。我們現在按“a”添加一個坐標軸：
此時程序自動創建了0號坐標軸，并進入了這一坐標軸。現在你可以按“x”退出這一坐標軸回到初始界面，還可以在初始界面按“0”回到這個坐標軸。現在我們要給這個坐標軸做定標。例如我們用這個坐標軸提取左圖中下面這張圖的數據。我們先點擊左邊的一個x軸刻度線（應該是一個豎直方向的短線；不是上圖左側大方框的刻度線，而是左圖大方框里面那兩個小矩形框邊上帶的那些短線），點上后會出現：
這時在左下角的文本框中輸入剛點擊的這個刻度值（比如0），然后按Enter鍵，圖中就會出現一條定標線：
如果需要，可以點擊這一條定標線（圖中藍線），刪除這條線或者在文本框中修改這條線的坐標值：
這里我們不需要修改，按“c”退出。類似地，我們可以點擊更多的x軸和y軸刻度，添加更多定標。建議每一個坐標軸添加至少3個定標。此時，如果刻度值輸錯了會有可能檢測到；另外，如果坐標是對數標度（log scale），只有添加三個定標才能檢測出來。如果3個定標但是刻度值有錯，會出現如下報錯提示：
這是因為最右邊應該是5而不是4。此時修改正確即可。一旦x，y坐標都已完成定標，右圖就會自動出現定標后的數據圖：
我們發現，這個坐標軸把不屬于自己的upper panel（上面的那組藍、黑散點和紅線）也包含進來了。所以我們需要按“a”設定最標軸區域。此時選擇方式和第二步一樣，用鼠標拖動選擇矩形。所有經過矩形內部的元素會被選中，程序會嘗試自動把一組散點當成一個元素。我們按“a”后可開始拖動選擇，選擇后如下：
可見此時這一個axis #0已經設定完成，我們成功獲得了數據。我們可以按“x”退出axis #0，重復上面步驟添加更多坐標軸。但考慮到這張示例圖里upper panel和lower panel共用x軸，我們可以按“u”復制一份當前坐標軸。然后我們進入到復制的新坐標軸，刪除舊的y軸定標，重新定標y軸，然后重新按“a”選擇坐標軸區域（別忘了這一步，否則取出的還是圖里的lower panel！）：
這樣我們就成功提取了圖中數據！
在適當時候，可以按“s”保存各個坐標軸（axes）信息，此時相應信息會保存在“example.pdf.axes”文件中。下次運行程序時會直接讀取這些信息，然后你還可以按相應數字回到某個坐標軸。注意目前的程序（0.1.1版本）不會在你退出程序（關閉窗口）時自動保存這一信息，需要你手動按“s”保存！保存過后，你就可以安全地關閉窗口，此時程序退出。
你還可以在適當時候按“e”導出能獲取的所有數據，數據會導出到“example.pdf.out”文件中。如果你已經在以前運行程序時保存過，在再次進入第3步時，如果你再次導出，原文件會被覆蓋。所以程序會需要你手動確認，才能進入第3步：
要取出導出的數據，可以在你的代碼中運行：
from vpextractor import DataExplorerdata = DataExplorer('example.pdf.out')
例如你需要取出第0個坐標軸（axis #0）中的數據，則用 data[0] 即可。目前支持導出的有散點（）和折線（lines）兩類數據，例如用 data[0][''] 可以取出axis #0中的散點數據。data[0][''] 是一個列表，列表中每一個元素是一個包含數據信息的字典。例如，data[0][''][0]['x'] 是axis #0中第0組散點的x坐標， data[0][''][0]['y'] 是它的y坐標。除’x’, ‘y’外，字典還包含一些其他關于數據的信息。