EasyDataverse เป็นไลบรารี Python ที่ใช้อินเทอร์เฟซการติดตั้ง Dataverse และสร้างอ็อบเจ็กต์ Python แบบไดนามิกที่เข้ากันได้กับการกำหนดค่าบล็อกข้อมูลเมตาที่กำหนดในการติดตั้ง Dataverse นอกจากนี้ EasyDataverse ยังช่วยให้คุณสามารถส่งออกและนำเข้าชุดข้อมูลเข้าและออกจากรูปแบบข้อมูลต่างๆ
เริ่มต้นใช้งาน EasyDataverse โดยรันคำสั่งต่อไปนี้
# Using PyPI
pip install easyDataverse
หรือสร้างตามแหล่งที่มา
pip install git+https://github.com/gdcc/easyDataverse.git
EasyDataverse สามารถเชื่อมต่อกับการติดตั้ง Dataverse ที่กำหนด และดึงข้อมูลช่องข้อมูลเมตาทั้งหมดและคุณสมบัติได้ วิธีนี้ช่วยให้คุณสร้างออบเจ็กต์ชุดข้อมูลที่มีช่องข้อมูลเมตาทั้งหมดและคุณสมบัติที่กำหนดในการติดตั้ง 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" )
EasyDataset ช่วยให้คุณสามารถดาวน์โหลดชุดข้อมูลจากการติดตั้ง Dataverse ใดก็ได้ ชุดข้อมูลที่ดาวน์โหลดจะแสดงเป็นโครงสร้างเชิงวัตถุ และสามารถใช้เพื่ออัปเดตข้อมูลเมตา/ไฟล์ ส่งออกชุดข้อมูลเป็นรูปแบบต่างๆ หรือใช้ในแอปพลิเคชันถัดไป
# 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 ()
คุณสามารถค้นหาสมุดบันทึกตัวอย่างอย่างละเอียดได้ในไดเร็กทอรีตัวอย่าง สมุดบันทึกนี้สาธิตแนวคิดพื้นฐานของ EasyDataverse และวิธีการใช้งานในทางปฏิบัติ
EasyDataverse
เป็นซอฟต์แวร์โอเพ่นซอร์สฟรีที่ได้รับอนุญาตภายใต้ใบอนุญาต MIT