Memulai
Paket MERMAID R (mermaidr) dirancang untuk membantu Anda dan kolaborator secara efisien mengakses, menganalisis, dan mengimpor data pemantauan terumbu karang dari platform MERMAID - langsung di dalam lingkungan R. Baik Anda bekerja dengan kumpulan data besar di beberapa lokasi, melakukan analisis lanjutan, atau mengintegrasikan data lama ke dalam data pemantauan yang sedang berlangsung, mermaidr merampingkan alur kerja Anda.
Apa yang dapat Anda lakukan dengan paket R ini
Dengan mermaidr, Anda dapat:
Mengakses dan mengekspor data proyek Anda dari MERMAID untuk analisis khusus.
Mengumpulkan set data dari beberapa proyek atau tahun survei.
Mengimpor data historis atau data lama ke dalam proyek-proyek MERMAID Anda.
Validasi data Anda terhadap templat MERMAID sebelum mengimpor.
Memanfaatkan templat kode analisis yang sudah jadi dari pusat analisis MERMAID.
Fitur-fitur ini menjadikan mermaidr alat yang berharga bagi mereka yang berada di komunitas MERMAID yang melakukan analisis, serta mereka yang mencari jalan yang efektif untuk mengintegrasikan data mereka ke dalam satu platform.
Persyaratan perangkat lunak
Sebelum memulai, pastikan Anda sudah menginstal R dan RStudio di komputer Anda.
Unduh R: https://cran.rstudio.com/
Unduh RStudio: https://posit.co/download/rstudio-desktop/
Program-program ini menyediakan lingkungan tempat Anda akan menjalankan paket mermaidr.
Menginstal mermaidr
Buka RStudio. Pada panel Console (kiri bawah secara default), atau pada file skrip baru (kiri atas), instal paket mermaidr langsung dari GitHub:
#install package from GitHub
install.packages("devtools")
devtools::install_github("data-mermaid/mermaidr")
# or use the "remotes" package to install mermaidr
remotes::install_github("data-mermaid/mermaidr")Kemudian muat paket:
#load package
library(mermaidr)Kunjungi situs web paket untuk dokumentasi terperinci, referensi fungsi, dan tutorial.
Untuk daftar lengkap fungsi yang tersedia: Referensi fungsi
Persyaratan autentikasi dan akses
Untuk mengakses proyek melalui mermaidr, Anda harus mengautentikasi sesi Anda. Untuk itu, Anda memerlukan akun MERMAID yang terverifikasi. Anda dapat mendaftar secara gratis di app.datamermaid.org. Setelah terautentikasi, mermaidr dapat melihat proyek mana saja yang dapat Anda akses.
Ketika Anda memanggil fungsi akses data proyek (misalnya, mermaid_get_my_projects() ), sebuah jendela browser akan secara otomatis terbuka meminta Anda untuk masuk dengan kredensial MERMAID Anda (baik menggunakan masuk Google atau nama pengguna dan kata sandi Anda - bagaimanapun Anda biasanya log in). Setelah diautentikasi, token akses akan tersimpan sementara untuk mengotorisasi sesi Anda. Tutup saja jendela peramban Anda dan kembali ke R setelah autentikasi selesai.
Catatan: Otentikasi hanya akan valid selama 24 jam. Setelah itu, Anda harus log in lagi saat menjalankan fungsi baru. Paket mermaidr menangani masa berlaku otentikasi Anda, cukup log in lagi ketika diminta. |
Anda dapat mengakses:
Proyek Anda sendiri - semua proyek MERMAID di mana Anda menjadi bagiannya (perlu otentikasi)
Proyek publik - proyek dengan kebijakan berbagi data yang diatur ke ringkasan publik (public summary) atau publik (public) - tidak perlu otentikasi
Akses ganda ini memungkinkan Anda untuk:
Analisis data proyek Anda sendiri
Gabungkan data dari berbagai proyek, situs, atau negara
Lakukan perbandingan regional
Lakukan sintesis global menggunakan data terumbu karang yang dapat diakses secara terbuka