Unduh easyDataverse - pengunduhan kode sumber easyDataverse

easyDataverse

Kode sumber lainnya

v0.4.1

Unduh

EasyDataverse adalah pustaka Python yang digunakan untuk menghubungkan instalasi Dataverse dan secara dinamis menghasilkan objek Python yang kompatibel dengan konfigurasi blok metadata yang diberikan pada instalasi Dataverse. Selain itu, EasyDataverse memungkinkan Anda mengekspor dan mengimpor kumpulan data ke dan dari berbagai format data.

Fitur

Kelas yang sesuai dengan Metadataconfig untuk pembuatan Kumpulan Data yang fleksibel.
Unggah dan unduh file dan direktori ke dan dari instalasi Dataverse.
Ekspor dan impor kumpulan data ke berbagai format (JSON, YAML dan XML).
Ambil kumpulan data dari instalasi Dataverse mana pun ke dalam struktur berorientasi objek yang siap diintegrasikan.

⚡️ Mulai cepat

Mulailah EasyDataverse dengan menjalankan perintah berikut

 # Using PyPI
pip install easyDataverse

Atau buat berdasarkan sumber

pip install git+https://github.com/gdcc/easyDataverse.git

Mulai cepat

Pembuatan kumpulan data

EasyDataverse mampu menyambung ke instalasi Dataverse tertentu dan mengambil semua bidang metadata dan propertinya. Hal ini memungkinkan Anda membuat objek himpunan data dengan semua bidang metadata dan propertinya yang diberikan pada instalasi Dataverse.

 from easyDataverse import Dataverse

# Connect to a Dataverse installation
dataverse = Dataverse (
  server_url = "https://demo.dataverse.org" ,
  api_token = "MY_API_TOKEN" ,
)

# Initialize a dataset
dataset = dataverse . create_dataset ()

# Fill metadata blocks
dataset . citation . title = "My dataset"
dataset . citation . subject = [ "Other" ]
dataset . citation . add_author ( name = "John Doe" )
dataset . citation . add_dataset_contact ( name = "John Doe" , email = "[email protected]" )
dataset . citation . add_ds_description ( value = "This is a description of the dataset" )

# Upload files or directories
dataset . add_file ( local_path = "./my.file" , dv_dir = "some/dir" )
dataset . add_directory ( dirpath = "./my_directory" , dv_dir = "some/dir" )

# Upload to the dataverse instance
dataset . upload ( "my_dataverse_id" )

Pengunduhan dan pembaruan kumpulan data

EasyDataset memungkinkan Anda mengunduh kumpulan data dari instalasi Dataverse mana pun. Kumpulan data yang diunduh direpresentasikan sebagai struktur berorientasi objek dan dapat digunakan untuk memperbarui metadata/file, mengekspor kumpulan data ke berbagai format, atau menggunakannya dalam aplikasi berikutnya.

 # Method 1: Download a dataset by its DOI
dataverse = Dataverse ( "https://demo.dataverse.org" )
dataset = dataverse . load_dataset (
    pid = "doi:10.70122/FK2/W5AGKD" ,
    version = "1" ,
    filedir = "place/for/data" ,
)

# Method 2: Download via URL
dataset , dataverse = Dataverse . from_ds_url (
    url = "https://demo.dataverse.org/dataset.xhtml?persistentId=doi:10.70122/XX/XXXXX&version=DRAFT" ,
    api_token = "MY_API_TOKEN"
)

# Display the content of the dataset
print ( dataset )

# Update metadata
dataset . citation . title = "My even nicer dataset"

# Synchronize with the dataverse instance
dataset . update ()

Dokumentasi dan contoh lainnya

Anda dapat menemukan buku catatan contoh menyeluruh di direktori contoh. Buku catatan ini mendemonstrasikan konsep dasar EasyDataverse dan cara menggunakannya dalam praktik.