inkovis
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.
so.py
Modul 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 direktorinotebook/
. 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.