_________ ____ ___ ___ / /__ __
/ ___/ __ / __ `__ / _ / __/ |/_/
/ /__/ /_/ / / / / / / __/ /__> <
___/____/_/ /_/ /_/___/__/_/|_|
ملحقات مفتوحة المصدر لـ Comet SDK.
يتم إنشاء هذه الملحقات ودعمها من قبل المجتمع وليست مشروعًا رسميًا لـ Comet ML. نحن نرحب بالمساهمات!
pip install cometx
لاستخدام وظائف سطر الأوامر هذه، ستحتاج إلى تعيين مفتاح Comet API الخاص بك بإحدى الطريقتين التاليتين.
إما بهذه الطريقة:
export COMET_API_KEY="YOUR-COMET-API-KEY"
أو بهذه الطريقة:
[comet]
api_key = YOUR-COMET-API-KEY
إذا كنت أحد مستخدمي Comet المحلي، فستحتاج أيضًا إلى تعيين متغير البيئة COMET_URL_OVERRIDE
، أو إضافته إلى ملف ~/.comet.config
الخاص بك كما هو موضح أدناه:
إما بهذه الطريقة:
export COMET_API_KEY="YOUR-COMET-API-KEY"
export COMET_URL_OVERRIDE="https://your-companys-comet.com/clientlib/"
أو بهذه الطريقة:
[comet]
api_key = YOUR-COMET-API-KEY
url_override = https://your-companys-comet.com/clientlib/
يتكون cometx
من سلسلة من الأوامر الفرعية المفيدة بشكل مستقل، ويمكن استخدامها معًا لإنشاء أدوات متطورة لإدارة تعلم الآلة.
سيتناول هذا القسم بعض الاستخدامات الشائعة، يليها استكشاف أكثر تفصيلاً لكل أمر فرعي.
سنستكشف في هذا القسم بعض السيناريوهات الشائعة.
المصطلح المفيد هو تعيين متغيرات بيئة Comet الخاصة بك على سطر أمر فرعي. بهذه الطريقة، يمكنك تعيين COMET_URL_OVERRIDE
و COMET_API_KEY
لعمليات تثبيت مختلفة.
بالطبع، لا يتعين عليك تعيين متغيرات البيئة إذا كنت تقوم بنسخ التجارب على نفس تثبيت Comet.
إليك كيفية تنزيل التجارب في WORKSPACE/PROJECT من http://comet.a.com:
COMET_URL_OVERRIDE=http://comet.a.com/clientlib
COMET_API_KEY=A-KEY
cometx download WORKSPACE/PROJECT
يقوم الأمر الفرعي cometx download
بتنزيل كافة بيانات تجربة Comet في ملفات محلية. لاحظ أن مساحة العمل/المشروع تشير إلى مساحة عمل ومشروع على http://comet.a.com.
يمكن للمرء بعد ذلك نسخ بيانات التجربة التي تم تنزيلها باستخدام أمر مماثل:
COMET_URL_OVERRIDE=http://comet.b.com/clientlib
COMET_API_KEY=B-KEY
cometx copy WORKSPACE/PROJECT NEW-WORKSPACE/NEW-PROJECT
لاحظ أن WORKSPACE/PROJECT يشير الآن إلى دليل، ويشير NEW-WORKSPACE/NEW-PROJECT إلى مساحة عمل ومشروع على http://comet.b.com.
وبالمثل، يمكن للمرء نسخ جميع المشاريع عن طريق تنزيلها أولاً:
COMET_URL_OVERRIDE=http://comet.a.com/clientlib
COMET_API_KEY=A-KEY
cometx download WORKSPACE
ومن ثم نسخها:
COMET_URL_OVERRIDE=http://comet.b.com/clientlib
COMET_API_KEY=B-KEY
cometx copy WORKSPACE NEW-WORKSPACE
وبالمثل، يمكن للمرء نسخ تجربة واحدة أولاً بتنزيلها:
COMET_URL_OVERRIDE=http://comet.a.com/clientlib
COMET_API_KEY=A-KEY
cometx download WORKSPACE/PROJECT/EXPERIMENT-NAME-OR-ID
ومن ثم نسخه:
COMET_URL_OVERRIDE=http://comet.b.com/clientlib
COMET_API_KEY=B-KEY
cometx copy WORKSPACE/PROJECT/EXPERIMENT-NAME-OR-ID NEW-WORKSPACE/NEW-PROJECT
بالنسبة لجميع الأوامر الفرعية، استخدم علامة --help
للحصول على معلومات إضافية.
يستخدم هذا الأمر من أجل:
أمثلة على قائمة Cometx:
cometx list WORKSPACE/PROJECT/EXPERIMENT-KEY-OR-NAME
cometx list WORKSPACE/PROJECT
cometx list WORKSPACE
cometx list
--query
- يستخدم للحد من تنزيل التجارب (راجع experience.api.query() لمزيد من المعلومات)-u
, --use-name
- استخدم أسماء التجارب لمجلدات وقوائم التجارب لمزيد من المعلومات، cometx list --help
يستخدم هذا الأمر من أجل:
أمثلة على نسخة المذنب:
cometx SOURCE DESTINATION
cometx --symlink SOURCE DESTINATION
حيث المصدر هو:
--symlink
أو المجلد "WORKSPACE/PROJECT/EXPERIMENT" أو "WORKSPACE/PROJECT/ " أو "WORKSPACE/ /*" (استخدم علامتي الاقتباس)--symlink
، فهو مسار Comet إلى مساحة العمل أو مساحة العمل/المشروعحيث تكون DESTINATION:
ليست كل المجموعات ممكنة:
الوجهة → المصدر ↓ | مساحة العمل | مساحة العمل/المشروع |
---|---|---|
WORKSPACE/*/* | نسخ كافة المشاريع | لا يوجد |
WORKSPACE/PROJ/* | لا يوجد | نسخ كافة التجارب |
WORKSPACE/PROJ/EXP | لا يوجد | تجربة النسخ |
لمزيد من المعلومات، cometx copy --help
يستخدم هذا الأمر من أجل:
أمثلة على تنزيل Cometx:
cometx download WORKSPACE/PROJECT/EXPERIMENT-KEY-OR-NAME [RESOURCE ...] [FLAGS ...]
cometx download WORKSPACE/PROJECT [RESOURCE ...] [FLAGS ...]
cometx download WORKSPACE [RESOURCE ...] [FLAGS ...]
cometx download [RESOURCE ...] [FLAGS ...]
حيث [RESOURCE...] تساوي صفرًا أو أكثر من الأسماء التالية:
إذا لم يتم توفير أي موارد، فسيتم تنزيلها جميعًا.
--query
- يستخدم للحد من تنزيل التجارب (راجع experience.api.query() لمزيد من المعلومات)--list
- يُستخدم لسرد مساحات العمل أو المشاريع أو التجارب أو المصنوعات اليدوية أو النماذج المتاحة (مثل cometx list
)--output
- تنزيل الموارد إلى مجلد آخر غير المجلد الحالي--flat
- لا تستخدم التسلسل الهرمي العادي للعناصر التي تم تنزيلها--use-name
- استخدم أسماء التجارب للمجلدات والقوائم--ignore
- لا تقم بتنزيل الموارد التالية (استخدم واحدًا أو أكثر من أسماء الموارد المذكورة أعلاه)--asset-type
- نوع الأصل المطلوب مطابقته، أو تركه ليتوافق مع الكل--filename
- اسم الملف المراد مطابقته، أو اتركه ليطابق الكل--overwrite
- الكتابة فوق أي ملفات موجودة--force
- لا تطلب التنزيل، فقط قم بذلك--help
- هذه الرسالةلتحميل التحف:
cometx download WORKSPACE/artifacts/NAME [FLAGS ...]
cometx download WORKSPACE/artifacts/NAME/VERSION-OR-ALIAS [FLAGS ...]
لتنزيل النماذج من سجل النماذج:
cometx download WORKSPACE/model-registry/NAME [FLAGS ...]
cometx download WORKSPACE/model-registry/NAME/VERSION-OR-STAGE [FLAGS ...]
لمزيد من المعلومات، cometx download --help
يُستخدم هذا الأمر لتسجيل ملف مورد (مقاييس، معلمات، أصول، إلخ) إلى تجربة أو تجارب محددة.
مثال سجل Cometx:
cometx log WORKSPACE/PROJECT/EXPERIMENT-KEY-OR-NAME [--type TYPE] FILENAME.EXT
حيث TYPE هو نوع الأصل لاسم الملف. TYPE غير مطلوب إذا كان ملحق اسم الملف (FILENAME.EXT) معروفًا.
الامتدادات المعروفة:
الأنواع المعروفة:
مثال لتعيين مفتاح آخر:القيمة:
cometx log WORKSPACE/PROJECT --type other --set "key:value"
cometx log WORKSPACE/PROJECT/EXPERIMENT-KEY-OR-NAME --type other --set "key:value"
سيقوم الإصدار الأول بتعيين المفتاح الآخر: القيمة في جميع التجارب في المشروع، وسيقوم الإصدار الثاني بتعيين المفتاح الآخر: القيمة في التجربة.
مثال لتسجيل كافة العناصر:
cometx log WORKSPACE/PROJECT PATH-TO-DOWNLOAD --type all
cometx log WORKSPACE/PROJECT/EXPERIMENT-KEY-OR-NAME PATH-TO-DOWNLOAD --type all
سيقوم الإصدار الأول بإنشاء تجربة، بينما سيقوم الإصدار الثاني بتسجيل كل شيء في تجربة موجودة.
--query
- يستخدم للحد من تنزيل التجارب (راجع experience.api.query() لمزيد من المعلومات)--type
- نوع العنصر المراد تسجيله--set
- "المفتاح: القيمة" للتسجيل لمزيد من المعلومات، cometx log --help
لحذف أصول التجارب:
cometx delete-assets WORKSPACE/PROJECT --type=image
cometx delete-assets WORKSPACE/PROJECT/EXPERIMENT --type=all
يمكن أن يكون نوع الأصول صالحًا، بما في ذلك:
لمزيد من المعلومات، cometx delete-assets --help
cometx reproduce [-h] [--run] [--executable EXECUTABLE] COMET_PATH OUTPUT_DIR
لمزيد من المعلومات، cometx reproduce --help
تحذير: سيؤدي تشغيل الاختبارات إلى إنشاء تجارب ونماذج وأصول وما إلى ذلك في مساحة العمل الافتراضية الخاصة بك إذا لم يتم تعيينها بطريقة أخرى.
لإجراء الاختبارات، يمكنك إما تصدير كل هذه العناصر إلى البيئة:
$ export COMET_USER= " "
$ export COMET_WORKSPACE= " "
$ export COMET_API_KEY= " "
$ pytest tests
أو قم بتحديد workspace
و api_key
في ملف ~/.comet.config الخاص بك:
$ export COMET_USER= " "
$ pytest tests