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.