模組:PrevalenceData/doc
呢版係模組:PrevalenceData嘅解說版
 | 呢個模組已經被評為beta版，可以廣泛用。因為佢新近完成，請慎用，以確保輸出結果符合預期。 |
名
[編輯]PrevalenceData——顯示已知發病率
簡述
[編輯]{{#invoke:PrevalenceData | main | qId= 維基數據號碼 }}
p.test()
用途
[編輯]模組主入口 main 收一個參數 qId，係某種病嘅維基數據號碼（Q 字頭數字），輸出對應病嘅已知發病率（P1193）。唔畀參數輸出空字串；如果發病率係限於某啲情況（即係所謂修飾子[暫譯]，qualifier，目前主要係睇國家或者地區），會用括弧括住。如果有出處，會 ｢盡人事｣ 畀埋出處（維基數據嘅出處好多時寫得好求其，只能夠 ｢盡人事｣，畀出處亦係呢度原創功能，比起主模組測試量更少）。
所有不明參數全部忽略，唔會出錯誤訊息；串錯 qId（包括錯大細楷）當不明參數，出空字串。
範例
[編輯]- 打：
{{#invoke:PrevalenceData|main|qId=Q190564}} - 出：0.0123%（英國）
上面例子嘅出處，可以睇到維基數據寫出處有幾求其（最後一個睇落咁正常，係因為佢係維基數據嘅正宗引書方法，其他基本上係引網）：
- ↑ PubMed publication ID 19692116。https://pubmed.ncbi.nlm.nih.gov/19692116
- ↑ https://doi.org/10.1007%2Fs11894-017-0558-9
- ↑ https://www.ncbi.nlm.nih.gov/pmc/articles/PMC4586575
- ↑ 4.0 4.1 Rebbeca A Grysiewicz、Kurian Thomas、Dilip K Pandey（2008年11月1號）。“Epidemiology of ischemic and hemorrhagic stroke: incidence, prevalence, mortality, and risk factors.”Neurologic Clinics 第26卷4期。doi:10.1016/J.NCL.2008.07.003。
注意
[編輯]參數名係 qId（中間大楷），唔係 qid。
參數 qId 畀咗就一定要有嘢，唔可以空白，空白會產生系統錯誤，號碼唔存在亦會產生系統錯誤。
測試
[編輯]呢度嘅版本可以用 test 函數做有限度測試，喺 Debug console 輸入 p.test()，測試成功冇輸出，失敗出錯誤訊息。礙於呢個模組用維基數據，測試失敗可能只係維基數據更新咗，遇到失敗嘅情況要睇係邊行，睇返 check 緊邊項維基數據，再判斷係模組出問題定數據變咗。
test 入面嘅測試全部都係粵語維基百科呢便自己做，同原作者無關。
人手睇模組輸出（例如搵緊點解測試失敗，或者整新 test case）可以用 print(p.main({args={qId='維基數據號碼'}}))。
來源
[編輯]呢個模組應該係來自英文維基百科，2016年推出，2024年引入，有本地化同本地有做一啲修正，但係冇加入英維喺2019年後做嘅改動。
同原版（包括目前嘅英維版）主要唔同：
- 除咗國家同地區之外，有一兩個同地區無關嘅修飾子都會處理（因為例如有啲病男女發病率唔同，唔寫明好誤導）
- 地區會睇埋 P131（極之常見嘅 ｢位於政區｣）
- 遇到明顯入錯嘅數據（負數或者大過 100%）會自動抌咗佢
- 有啲情況會加文章入追蹤類，方便搵問題
- 如果維基數據有記出處，會 ｢盡人事｣ 畀埋出處
睇埋
[編輯]- Category:P1193 同時出現有括弧同冇括弧數值
- Category:P1193 多過一個冇括弧數值
- Category:P1193 維基數據遇到未知修飾子
- Category:P1193 維基數據遇到無效數值