taruma / inkovis

Visualisasi Data Infeksi Menggunakan Matplotlib

inkovis

---

Update 2 Juni 2020:

PROYEK INKOVIS (DATASET INKOVIS) TIDAK DIPERBARUI LAGI SEJAK 1 JUNI 2020. Anda dapat memperbarui dataset dengan menggunakan script yang telah tersedia (auto_update.py). Proyek ini akan disimpan sebagai arsip. Seluruh github actions akan dimatikan.

---

Proyek inkovis diawali sebagai proyek modul python bernama inkovis.py untuk memvisualisasikan data infeksi covid-19 di Indonesia. Seiringnya waktu, proyek inkovis menyediakan dataset covid-19 Indonesia yang diperoleh dari laporan situasi terkini (situation report) harian yang dilaporkan di situs covid19.kemkes.go.id.

Ringkasnya proyek inkovis berisikan:

• Modul python bernama inkovis.py untuk memvisualisasikan dataset covid19 di Indonesia.
• Wadah penyimpanan berbagai notebook terkait visualisasi dataset.
• Menyediakan dataset covid-19 Indonesia yang diperoleh dari laporan situasi terkini. Dataset tersedia sebagai kaggle dataset disini. Dataset hanya akan diperbarui sampai akhir Mei 2020.

---

Proyek (situs dan dataset) akan diperbarui melalui otomasi menggunakan Github Actions. Proyek ini terbuka untuk dikembangkan/dimodifikasi lebih lanjut baik melalui pull request atau terpisah (fork).

---

Github Actions

Github Actions	Status
execnb
updatedata
updatesite

Catatan: Per 15 Mei 2020, github actions yang terjadwal hanya updatedata.

---

Notebook

Berikut notebook/pos yang menggunakan modul/dataset inkovis:

Latar Belakang

• [Kaggle]: Visualisasi Data COVID-19 di Indonesia. Visualisasinya menggunakan dataset yang tersedia di kaggle. Pada buku ini juga dijelaskan latar belakang pada pembuatan visualisasinya.
• [Github]: visualisasi_data_covid19_indonesia.ipynb. Buku ini serupa dengan Kaggle: Visualisasi Data COVID-19 di Indonesia, yang membedakan hanya dataset dan periode yang digunakan. Dataset menggunakan yang tersedia di repo ini, dan periode yang digunakan adalah 31 hari terakhir. Lihat buku ini menggunakan NBViewer.

Kumpulan Grafik

• [Github]: kumpulan_grafik_31akhir.md. Berisikan kumpulan grafik dengan periode 31 hari terakhir.

Penggunaan Modul Inkovis

• [Github]: inkovis_nb.ipynb. Buku ini meragakan fungsi yang tersedia di modul inkovis. Lihat buku ini menggunakan NBViewer.

---

Contoh Grafik

Kunjungi situs hidrokit.github.io/inkovis.

---

Modul inkovis

Pemasangan

Untuk menggunakan modul inkovis, dibutuhkan dua modul yaitu inkovis.py dan so.py. inkovis.py merupakan modul utama yang berisikan fungsi untuk memvisualisasikan data. so.py merupakan modul tambahan yang berisikan fungsi dari orang lain yang digunakan. Paket numpy, pandas, dan matplotlib harus telah dipasang sebelum menggunakan modul inkovis.

Jika menggunakan jupyter notebook/google colab/kaggle kernel, bisa menggunakan kode berikut:

!wget -O inkovis.py "https://github.com/hidrokit/inkovis/raw/master/notebook/inkovis.py" -q
!wget -O so.py "https://github.com/hidrokit/inkovis/raw/master/notebook/so.py" -q

Atau bisa juga diunduh filenya pada tautan berikut: inkovis.py, so.py.

Penggunaan

Fungsi yang tersedia pada modul inkovis meminta input dataset objek pandas.DataFrame dan objek matplotlib.axes.Axes. DataFrame yang digunakan harus memiliki kolom: jumlah_periksa, konfirmasi, sembuh, meninggal, negatif, proses_periksa.

Contoh penggunaan:

import inkovis

fig, ax = plt.subplots()

inkovis.plot_confirmed_case(dataset, ax)

Variasi penggunaan modul bisa dilihat pada buku [Github]: inkovis_nb.ipynb.

Dokumentasi

Untuk saat ini, belum tersedia dokumentasi mengenai penggunaan modul inkovis.

Modul so.py

Modul inkovis menggunakan potongan kode/fungsi orang lain yang disimpan pada file so.py:

• Fungsi align_yaxis_np(), [From Stackoverflow]: Matplotlib axis with two scales shared origin. Menggunakan potongan kode yang disediakan oleh Tim P.

---

Dataset

Informasi mengenai dataset bisa membuka dataset untuk lebih detail.

Dataset tersedia juga dalam bentuk kaggle dataset disini.

---

Berkontribusi

Kontribusi dapat berupa:

• Pengembangan/modifikasi modul inkovis.py
• Dokumentasi (Dokumen Github, docstring)
• Pembaruan dataset
• Notebook (.ipynb)
• dll.

Kontribusi dataset

Jika ingin berkontribusi dalam dataset berupa pembaruan, dapat memperbarui berkas data_infeksi_covid19_indonesia.csv. Pada judul pull request tambahkan [execnb] untuk memperbarui seluruh notebook yang tersedia di repo ini.

---

Github Actions

Pada repo ini menggunakan layanan Github Actions yang mengotomasi beberapa pekerjaan. Github Actions yang aktif di repo ini antara lain:

• execnb (pasif): Mengeksekusi seluruh notebook .ipynb pada direktori notebook/. Actions ini hanya aktif saat menggunakan kata kunci [execnb] pada judul pull request atau pesan commit. Otomasi ini digunakan untuk memperbarui notebook di github dan gambar/grafik yang digunakan di github atau situs lainnya.
• updatedata (terjadwal 17.00 WIB): memperbarui dataset inkovis berdasarkan laporan situasi terkini. Diasumsikan bahwa laporannya menggunakan penamaan yang sama beserta alamat yang sama.
• updatesite (terjadwal 17.30 WIB): memproduksi grafik yang digunakan oleh situs (untuk halaman grafik 31 hari terakhir). Github Actions ini tidak dilanjutkan lagi per 15 Mei 2020.