Hist عبارة عن واجهة أمامية صديقة للمحللين للرسم البياني المعزز، مصممة لـ Python 3.8+ (يحصل المستخدمون من 3.6 إلى 3.7 على إصدارات أقدم). انظر ما هو الجديد.
يمكنك تثبيت هذه المكتبة من PyPI باستخدام النقطة:
python3 -m pip install " hist[plot,fit] "
إذا لم تكن بحاجة إلى ميزات الرسم، فيمكنك تخطي الإضافات [plot]
و/أو [fit]
. [fit]
غير مدعوم حاليًا في WebAssembly.
يوفر Hist حاليًا كل ما يوفره الرسم البياني المعزز والتحسينات التالية:
Hist يزيد المحاور بالأسماء:
name=
هو تسمية فريدة تصف كل محور.label=
عبارة عن سلسلة اختيارية تُستخدم في التخطيط ( name
الافتراضي إذا لم يتم توفيره).NamedHist
التجريبي عبارة عن Hist
الذي يعطل معظم أشكال الوصول الموضعي، مما يجبر المستخدمين على استخدام الأسماء فقط. تعمل فئة Hist
على زيادة bh.Histogram
ببناء أبسط:
flow=False
طريقة سريعة لإيقاف التدفق للمحاور الموجودة في البناء.storage=
يمكن حذفه، ويمكن أن تكون السلاسل والمخازن موضعية.data=
يمكنه تهيئة الرسم البياني بالبيانات الموجودة.Hist.from_columns
للتهيئة باستخدام DataFrame أو الإملاء.دعم Hist QuickConstruct، وهو نظام بناء خالٍ من الاستيراد ولا يتطلب واردات إضافية:
Hist.new.().().()
.Regular
) أو قصيرة ( Reg
).data=
) في وحدة التخزين.ميزات الرسم البياني الموسعة:
.name
و .label
، مثل المحاور..density()
يحسب الكثافة كمصفوفة..profile(remove_ax)
تحويل الرسم البياني ND COUNT إلى رسم بياني (N-1)D MEAN..sort(axis)
فرز الرسم البياني حسب المحور الفئوي. يأخذ بشكل اختياري وظيفة للفرز حسب..fill_flattened(...)
سيتم تسطيحه وملئه، بما في ذلك دعم AwkwardArray..integrate(...)
، الذي يأخذ الوسيطات المعاكسة كـ .project
.ينفذ اصمت UHI+؛ امتداد لنظام UHI (فهرسة الرسم البياني الموحد) المصمم للتفاعل الخالي من الاستيراد:
j
للتبديل إلى إحداثيات البيانات في الوصول أو الشرائح.j
على الشرائح لإعادة التركيب.إجراءات التخطيط السريعة تشجع على الاستكشاف:
.plot()
مخططات أحادية وثنائية الأبعاد (أو استخدم plot1d()
و plot2d()
).plot2d_full()
مشاريع أحادية الأبعاد حول قطعة أرض ثنائية الأبعاد..plot_ratio(...)
قم بإنشاء مخطط نسبة بين الرسم البياني ورسم بياني آخر أو قابل للاستدعاء..plot_pull(...)
ينفذ مخطط سحب..plot_pie()
ينشئ مخططًا دائريًا..show()
نسخة مطبوعة رائعة باستخدام Histoprint.الأكوام: العمل مع مجموعات من الرسوم البيانية ذات المحاور المتطابقة
h.stack(axis)
باستخدام فهرس أو اسم المحور (محور StrCategory
مثالي).hist.stacks.Stack(h1, h2, ...)
أو استخدام from_iter
أو from_dict
..plot()
و .show()
بأسماء (تسميات المخططات افتراضية لمعلومات المحاور الأصلية)..project
و *
و +
و -
.وحدات جديدة
intervals
تدعم فترات التغطية المتكررة.دفتر ملاحظات جاهز: يتمتع Hist بتمثيل رائع داخل دفتر الملاحظات.
from hist import Hist
# Quick construction, no other imports needed:
h = (
Hist . new . Reg ( 10 , 0 , 1 , name = "x" , label = "x-axis" )
. Var ( range ( 10 ), name = "y" , label = "y-axis" )
. Int64 ()
)
# Filling by names is allowed:
h . fill ( y = [ 1 , 4 , 6 ], x = [ 3 , 5 , 2 ])
# Names can be used to manipulate the histogram:
h . project ( "x" )
h [{ "y" : 0.5j + 3 , "x" : 5j }]
# You can access data coordinates or rebin with a `j` suffix:
h [ 0.3j :, :: 2j ] # x from .3 to the end, y is rebinned by 2
# Elegant plotting functions:
h . plot ()
h . plot2d_full ()
h . plot_pull ( Callable )
من خلال الخروج من git، استخدم nox أو قم بتشغيل:
python -m pip install -e .[dev]
راجع إرشادات المساهمة للحصول على معلومات حول إعداد بيئة التطوير.
نود أن نعرب عن شكرنا للمساهمين الذين جعلوا هذا المشروع ممكنًا (مفتاح الرموز التعبيرية):
هنري شراينر ؟ | نينو لاو ؟ | كريس بور | نيك أمين | إدواردو رودريجيز | أندريه نوفاك | ماثيو فيكرت |
كايل كرنمر | دانيال أنتريم | نيكولاس سميث | مايكل إلياتشيفيتش | جوناس ايشل |
يتبع هذا المشروع مواصفات جميع المساهمين.
تم تطوير هذه المكتبة في المقام الأول بواسطة هنري شراينر ونينو لاو.
تم تقديم الدعم لهذا العمل من خلال الاتفاقية التعاونية لمؤسسة العلوم الوطنية OAC-1836650 (IRIS-HEP) وOAC-1450377 (DIANA/HEP). أي آراء أو نتائج أو استنتاجات أو توصيات تم التعبير عنها في هذه المادة هي آراء المؤلفين ولا تعكس بالضرورة آراء المؤسسة الوطنية للعلوم.