ما هي وسيطات "المستويات" و"المفاتيح" والأسماء في وظيفة concat لـ Pandas؟

تعد وظيفة pandas.concat أداة قوية للجمع كائنات متسلسلة أو DataFrame متعددة على طول محور محدد. بالإضافة إلى الوسيطات الأساسية لتحديد الكائنات المراد تسلسلها والمحور الذي سيتم تسلسلها، يوفر concat أيضًا العديد من الوسائط الاختيارية التي تسمح لك بتخصيص المخرجات الناتجة. ثلاث من هذه الوسيطات هي المستويات والمفاتيح والأسماء.

المستويات

يتم استخدام وسيطة المستويات لتحديد مستويات MultiIndex الناتجة. إذا لم يتم تحديد المستويات، فسوف يستنتج الباندا المستويات من المفاتيح. ومع ذلك، يمكنك تحديد مستويات لتجاوز المستويات المستنتجة أو لإنشاء MultiIndex مع مجموعة محددة من المستويات.

تأخذ وسيطة المستويات قائمة من التسلسلات. يمثل كل تسلسل مستوى واحد من MultiIndex. يمكن أن تكون التسلسلات أي نوع من الكائنات التي يمكن استخدامها لإنشاء كائن pandas.Index.

على سبيل المثال، يقوم التعليمة البرمجية التالية بإنشاء MultiIndex بمستويين:

df = pd.concat([df1, df2], keys=[['a', 'b'], ['c', 'd']], levels=[['A', 'B'], ['C', 'D']])

سيكون للفهرس المتعدد الناتج مستويين، 'A' و'B'، ومستويين، 'C' و'D'. سيكون المستوى الأول من MultiIndex هو القيمتين 'a' و'b'، وسيكون المستوى الثاني هو القيمتين 'c' و'd'.

keys

وسيطة المفاتيح يتم استخدامه لتحديد مفاتيح ملف MultiIndex الناتج. إذا لم يتم تحديد المفاتيح، فسيستخدم Pandas أسماء الكائنات المتسلسلة. ومع ذلك، يمكنك تحديد مفاتيح لتجاوز المفاتيح المستنتجة أو لإنشاء MultiIndex بمجموعة محددة من المفاتيح.

تأخذ وسيطة المفاتيح قائمة من الكائنات. يمثل كل كائن مفتاحًا واحدًا لـ MultiIndex الناتج. يمكن أن تكون الكائنات أي نوع من الكائنات التي يمكن استخدامها لإنشاء كائن pandas.Index.

على سبيل المثال، يقوم التعليمة البرمجية التالية بإنشاء MultiIndex بمفتاحين:

df = pd.concat([df1, df2], keys=['a', 'b'])

سيحتوي الفهرس المتعدد الناتج على مفتاحين، 'a' و'b'. سيكون المستوى الأول من MultiIndex هو القيمة 'a'، وسيكون المستوى الثاني هو القيمة 'b'.

الأسماء

يتم استخدام وسيطة الأسماء لتحديد أسماء مستويات MultiIndex الناتجة. إذا لم يتم تحديد الأسماء، فسيستخدم Pandas أسماء الكائنات المتسلسلة. ومع ذلك، يمكنك تحديد أسماء لتجاوز الأسماء المستنتجة أو لإنشاء MultiIndex بمجموعة محددة من الأسماء.

تأخذ وسيطة الأسماء قائمة من السلاسل. تمثل كل سلسلة اسمًا لمستوى واحد من MultiIndex الناتج. يمكن أن تكون السلاسل أي سلسلة صالحة.

على سبيل المثال، تقوم التعليمة البرمجية التالية بإنشاء MultiIndex باسمين:

df = pd.concat([df1, df2], keys=[['a', 'b'], ['c', 'd']], names=['A', 'B'])

سيكون للفهرس المتعدد الناتج اسمان، "A" " و"ب". سيكون المستوى الأول من MultiIndex هو القيمتين 'a' و'b'، وسيكون المستوى الثاني هو القيمتين 'c' و'd'.