statsbombpy

statsbombpy

هذا المستودع، الذي قدمته لك StatsBomb، عبارة عن حزمة Python تتيح للمستخدمين دفق بيانات StatsBomb بسهولة إلى Python باستخدام بيانات اعتماد تسجيل الدخول الخاصة بك لواجهة برمجة التطبيقات (API) أو البيانات المجانية من صفحة GitHub الخاصة بنا. الوصول إلى واجهة برمجة التطبيقات (API) مخصص للعملاء الذين يدفعون فقط

الدعم: [email protected]

تعليمات التثبيت

pip install statsbombpy

تشغيل الاختبارات

nose2 -v --pretty-assert

إعدادات

المصادقة

متغيرات البيئة

يمكن إجراء المصادقة عن طريق تعيين متغيرات البيئة المسماة SB_USERNAME و SB_PASSWORD على بيانات اعتماد تسجيل الدخول الخاصة بك.

المكالمات اليدوية

وبدلاً من ذلك، إذا كنت لا ترغب في استخدام متغيرات البيئة، فإن جميع الوظائف تقبل creds الوسيطة لتمرير بيانات اعتماد تسجيل الدخول الخاصة بك بالتنسيق {"user": "", "passwd": ""}

التزامن

يمكنك تحديد عدد مراكز جهاز الكمبيوتر الخاص بك التي سيتم استخدامها عند تشغيل وظائف sb.competition_events() و sb.competition_frames() عن طريق تعيين متغير البيئة SB_CORES على الرقم الذي تريد استخدامه. سيؤدي السماح لـ statsbombpy باستخدام المزيد من النوى إلى تسريع هذه الوظائف.

إذا لم يكن لديك مجموعة متغيرات بيئة، فسنحاول اكتشاف عدد النوى في نظامك واستخدام 2 أقل من هذا العدد. إذا لم نتمكن من اكتشاف عدد النوى، فإننا نضبط الرقم على 4.

البيانات المفتوحة

يمكن الوصول إلى بيانات StatsBomb المفتوحة دون الحاجة إلى المصادقة.

تلتزم StatsBomb بمشاركة البيانات والأبحاث الجديدة علنًا لتعزيز فهم لعبة كرة القدم. نريد أن نشجع بنشاط البحث والتحليل الجديد على جميع المستويات. ولذلك، فقد جعلنا بعض رابطات StatsBomb Data متاحة مجانًا للاستخدام العام للمشاريع البحثية والاهتمام الحقيقي بتحليلات كرة القدم.

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

الشروط والأحكام

في حين أننا نحرص على مشاركة البيانات وتسهيل البحث، فإننا نحثك أيضًا على أن تكون مسؤولاً عن البيانات. يرجى تسجيل التفاصيل الخاصة بك على https://www.statsbomb.com/resource-centre وقراءة اتفاقية المستخدم الخاصة بنا بعناية. باستخدام هذا المستودع، فإنك توافق على اتفاقية المستخدم. إذا قمت بنشر أو مشاركة أو توزيع أي بحث أو تحليل أو رؤى بناءً على هذه البيانات، فيرجى ذكر مصدر البيانات باسم StatsBomb واستخدام شعارنا.

الاستخدام

 from statsbombpy import sb

المسابقات

 sb.competitions()

	معرف_المنافسة	season_id	اسم_البلد	اسم المنافسة	منافسة_الجنس	season_name	match_updated	match_available
0	9	42	ألمانيا	1. الدوري الألماني	ذكر	2019/2020	2019-12-29T07:47:45.981	2019-12-29T07:47:45.981
1	9	4	ألمانيا	1. الدوري الألماني	ذكر	2018/2019	2019-12-16T23:09:16.168756	2019-12-16T23:09:16.168756
2	9	1	ألمانيا	1. الدوري الألماني	ذكر	2017/2018	2019-12-16T23:09:16.168756	2019-12-16T23:09:16.168756
3	78	42	كرواتيا	1. إتش إن إل	ذكر	2019/2020	2020-01-02T10:35:49.065	2020-01-02T10:35:49.065
4	10	42	ألمانيا	2. الدوري الألماني	ذكر	2019/2020	2019-12-27T00:36:37.498	2019-12-27T00:36:37.498

مباريات

 sb.matches(competition_id=9, season_id=42)

	match_id	match_date	Kick_off	مسابقة	موسم	home_team	Away_team	home_score	Away_Score	match_status	last_updated	match_week	match_stage	الملعب	الحكم	home_managers	بعيدا_المديرين	data_version	shot_fidelity_version	xy_fidelity_version
0	303299	2019-12-15	18:00:00.000	ألمانيا - 1. الدوري الألماني	2019/2020	شالكه 04	اينتراخت فرانكفورت	1	0	متاح	2019-12-17T09:50:17.558	15	الموسم العادي	فيلتينز أرينا	ف. زواير	ديفيد فاغنر	عدي هوتر	1.1.0	2	2
1	303223	2019-09-01	18:00:00.000	ألمانيا - 1. الدوري الألماني	2019/2020	اينتراخت فرانكفورت	فورتونا دوسلدورف	2	1	متاح	2019-12-16T23:09:16.168756	3	الموسم العادي	كوميرزبانك أرينا	واو ويلينبورج	عدي هوتر	فريدهيلم فونكل	1.1.0	2	2
2	303083	2019-12-15	15:30:00.000	ألمانيا - 1. الدوري الألماني	2019/2020	فولفسبورج	بوروسيا مونشنغلادباخ	2	1	متاح	2019-12-17T15:52:17.843	15	الموسم العادي	ساحة فولكس واجن	واو بريش	أوليفر جلاسنر	ماركو روز	1.1.0	2	2
3	303266	2019-12-14	15:30:00.000	ألمانيا - 1. الدوري الألماني	2019/2020	هيرتا برلين	فرايبورغ	1	0	متاح	2019-12-17T17:43:18.285	15	الموسم العادي	أوليمبياستاديون برلين	واو ويلينبورج	يورغن كلينسمان	كريستيان ستريش	1.1.0	2	2
4	303073	2019-12-21	15:30:00.000	ألمانيا - 1. الدوري الألماني	2019/2020	بايرن ميونخ	فولفسبورج	2	0	متاح	2019-12-23T18:02:36.454	17	الموسم العادي	أليانز أرينا	ج. دينجيرت	هانز ديتر فليك	أوليفر جلاسنر	1.1.0	2	2

الاصطفافات

 sb.lineups(match_id=303299)["Eintracht Frankfurt"]

	player_id	player_name	player_nickname	تاريخ الميلاد	player_gender	player_height	player_weight	Jersey_number	دولة
0	3204	ألمامي توريه	لا أحد	28/04/1996	ذكر	182.0	72.0	18	مالي
1	5591	فيليب كوستيتش	لا أحد	01/11/1992	ذكر	184.0	82.0	10	صربيا
2	7713	أوبيتي إيفان ن"ديكا	إيفان نديكا	20/08/1999	ذكر	190.0	نان	2	فرنسا
3	8307	مارتن هينتريجر	لا أحد	07/09/1992	ذكر	184.0	83.0	13	النمسا
4	8669	ميات جاسينوفيتش	لا أحد	08/02/1995	ذكر	175.0	66.0	11	صربيا

الأحداث

تقوم الإعدادات الافتراضية للاستعلام عن الأحداث بإرجاع إطار بيانات واحد يحتوي على جميع أنواع الأحداث وسماتها.

 events = sb.events(match_id=303299)

	ball_receipt_outcome	ball_recovery_offensive	ball_recovery_recovery_failure	block_deflection	تحمل_end_location	Clear_aerial_won	Clear_body_part	Clear_head	Clear_left_foot	Clear_right_foot	مكافحة الضغط	dribble_no_touch	dribble_outcome	dribble_overrun	Duel_outcome	Duel_type	مدة	خطأ_ملتزم_ميزة	بطاقة_خطأ_ملتزم بها	foul_won_advantage	foul_won_defensive	حارس_الجسم_جزء	حارس المرمى_end_location	goal_outcome	حارس المرمى_موقف	goal_technique	حارس المرمى_نوع	بطاقة تعريف	فِهرِس	إصابة_توقف_في_سلسلة	Interception_outcome	موقع	match_id	دقيقة	off_camera	خارج	pass_aerial_won	pass_angle	pass_assisted_shot_id	pass_body_part	pass_cross	pass_cut_back	pass_deflected	pass_end_location	pass_goal_assist	pass_height	pass_length	pass_outcome	pass_outswinging	pass_recipient	pass_shot_assist	pass_straight	pass_switch	pass_technique	pass_through_ball	pass_type	pass_xclaim	فترة	play_pattern	لاعب	موضع	تملُّك	حيازة_فريق	ذات الصلة_الأحداث	ثانية	shot_aerial_won	shot_body_part	shot_end_location	shot_first_time	shot_freeze_frame	shot_key_pass_id	shot_one_on_one	shot_outcome	shot_statsbomb_xg	shot_statsbomb_xg2	shot_technique	shot_type	substitution_outcome	substitution_replacement	فريق	الطابع الزمني	يكتب	under_pressure
500	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	3.498736	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	84828c06-41b5-44eb-aa92-1710bdb818ac	1838	نان	نان	[50.1، 16.6]	303299	47	نان	نان	نان	2.720095	نان	القدم اليسرى	نان	نان	نان	[13.3، 33.1]	نان	ممر أرضي	40.329765	نان	نان	فريدريك رونو	نان	نان	نان	نان	نان	نان	نان	2	اللعب العادي	أوبيتي إيفان ن"ديكا	مركز الظهير الأيسر	103	اينتراخت فرانكفورت	[ae3094e3-faa3-4608-8284-d9b8cca77711، c1202f1c-0831-4e88-83b2-597f56f0c858]	52	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	اينتراخت فرانكفورت	00:02:52.438	يمر	حقيقي
501	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	3.604236	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	9061cd20-513b-499f-b925-f1de5f241281	1840	نان	نان	[13.3، 33.1]	303299	47	نان	نان	نان	-0.153945	نان	القدم اليمنى	نان	نان	نان	[77.1، 23.2]	نان	تمريرة عالية	64.563540	غير مكتمل	نان	ميات جاسينوفيتش	نان	نان	نان	نان	نان	نان	نان	2	اللعب العادي	فريدريك رونو	حارس المرمى	103	اينتراخت فرانكفورت	[8e6495a7-782a-4f1a-845f-3ec50d761a1e، ff758a12-1ba6-4dd4-8b2c-7d39aa7aed97]	55	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	اينتراخت فرانكفورت	00:02:55.937	يمر	نان
502	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	2.101999	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	8e6495a7-782a-4f1a-845f-3ec50d761a1e	1842	نان	نان	[43.0، 56.9]	303299	47	نان	نان	نان	-0.703110	نان	رأس	نان	نان	نان	[64.0، 39.1]	نان	تمريرة عالية	27.528894	نان	نان	أمين حارث	نان	نان	نان	نان	نان	استعادة	نان	2	اللعب العادي	أوزان محمد كباك	مركز الظهير الأيمن	104	شالكه 04	[9061cd20-513b-499f-b925-f1de5f241281، be6dfe7d-7596-4cc2-8cd9-8c17d064317e]	59	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	شالكه 04	00:02:59.541	يمر	نان
503	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	1.187459	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	86431bc7-210a-4868-8e18-26ff38becefc	1854	نان	نان	[65.9، 12.6]	303299	48	نان	نان	نان	-0.730239	نان	القدم اليمنى	نان	نان	نان	[74.5، 4.9]	نان	ممر أرضي	11.543396	نان	نان	أمين حارث	نان	نان	نان	نان	نان	نان	نان	2	اللعب العادي	سوات سردار	خط الوسط الدفاعي الأيسر	104	شالكه 04	[761b4e65-8f64-464c-8153-6a98465208ba]	7	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	شالكه 04	00:03:07.689	يمر	نان
504	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	0.766628	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	6e58c713-622c-4246-8243-e4162e487a1c	1858	نان	نان	[79.1، 10.5]	303299	48	نان	نان	نان	1.254940	نان	القدم اليمنى	نان	نان	نان	[84.1، 25.8]	نان	ممر أرضي	16.096273	نان	نان	الحاخام ماتوندو	نان	نان	نان	نان	نان	نان	نان	2	اللعب العادي	أمين حارث	مركز خط الوسط الهجومي	104	شالكه 04	[b1960a76-d3ae-4ef3-a2cd-47eca8c25e0a، dd1575c0-a408-4177-944d-7e86d2f79181]	11	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	شالكه 04	00:03:11.719	يمر	حقيقي

من الممكن أيضًا الحصول على إطارات بيانات مميزة لكل نوع حدث و/أو الحصول على سمات حدث مميزة في أعمدتها الخاصة

 sb.events(match_id=303299, split=True, flatten_attrs=False)["dribbles"]

	بطاقة تعريف	فِهرِس	فترة	الطابع الزمني	دقيقة	ثانية	يكتب	تملُّك	حيازة_فريق	play_pattern	فريق	لاعب	موضع	موقع	مدة	under_pressure	ذات الصلة_الأحداث	سال لعابه	match_id
0	b190c01f-ad24-468c-8241-f955b91d996c	131	1	00:02:08.032	2	8	سال لعابه	4	شالكه 04	اللعب العادي	شالكه 04	دانيال كاليجيوري	الجناح الأيمن	[110.2، 62.9]	0.000000	حقيقي	[60f822df-5747-4787-b0f9-45bf5217eb8a]	{'النتيجة': {'المعرف': 8، 'الاسم': 'مكتمل'}}	303299
1	4d773c92-f89f-491e-b3e0-3a1d2e863148	399	1	00:08:48.623	8	48	سال لعابه	18	شالكه 04	اللعب العادي	شالكه 04	أمين حارث	مركز خط الوسط الهجومي	[88.9، 22.7]	0.000000	حقيقي	[93d829df-eea7-416b-95aa-7593828cfade]	{'النتيجة': {'المعرف': 8، 'الاسم': 'مكتمل'}}	303299
2	8a78dce4-998a-4e81-902c-9f3957cebc9d	460	1	00:13:30.202	13	30	سال لعابه	23	شالكه 04	اللعب العادي	شالكه 04	دانيال كاليجيوري	الجناح الأيمن	[99.5، 68.1]	0.007309	حقيقي	[772c5aae-e34e-4364-8a98-7caf7636c90b]	{'النتيجة': {'المعرف': 9، 'الاسم': 'غير مكتمل'}}	303299
3	e44d0122-2f2e-4771-820d-cc326a8b0379	496	1	00:14:10.135	14	10	سال لعابه	24	شالكه 04	من رمي في	شالكه 04	سوات سردار	خط الوسط الدفاعي الأيسر	[41.2، 31.7]	0.000000	حقيقي	[4de4039f-7efc-461b-b7d6-27c32ec2cd2a]	{'النتيجة': {'المعرف': 8، 'الاسم': 'مكتمل'}}	303299
4	9555afbd-d838-42c9-8f80-be3cd09e4c4a	793	1	00:20:18.409	20	18	سال لعابه	33	اينتراخت فرانكفورت	اللعب العادي	اينتراخت فرانكفورت	تيموثي تشاندلر	ظهير أيمن	[81.8، 75.7]	0.000000	حقيقي	[a5c88cee-6319-4c25-91cd-8a028d8dbfbf]	{'النتيجة': {'المعرف': 9، 'الاسم': 'غير مكتمل'}}	303299

أحداث المنافسة

يمكن الاستعلام عن جميع الأحداث الخاصة بمسابقة معينة وتخزينها في إطار بيانات واحد

 events = sb.competition_events(
    country="Germany",
    division= "1. Bundesliga",
    season="2019/2020",
    gender="male"
)

grouped_events = sb.competition_events(
    country="Germany",
    division= "1. Bundesliga",
    season="2019/2020",
    split=True
)
grouped_events["dribbles"]

	بطاقة تعريف	فِهرِس	فترة	الطابع الزمني	دقيقة	ثانية	يكتب	تملُّك	حيازة_فريق	play_pattern	فريق	لاعب	موضع	موقع	مدة	under_pressure	ذات الصلة_الأحداث	سال لعابه	match_id
0	b190c01f-ad24-468c-8241-f955b91d996c	131	1	00:02:08.032	2	8	سال لعابه	4	شالكه 04	اللعب العادي	شالكه 04	دانيال كاليجيوري	الجناح الأيمن	[110.2، 62.9]	0.000000	حقيقي	[60f822df-5747-4787-b0f9-45bf5217eb8a]	{'النتيجة': {'المعرف': 8، 'الاسم': 'مكتمل'}}	303299
1	4d773c92-f89f-491e-b3e0-3a1d2e863148	399	1	00:08:48.623	8	48	سال لعابه	18	شالكه 04	اللعب العادي	شالكه 04	أمين حارث	مركز خط الوسط الهجومي	[88.9، 22.7]	0.000000	حقيقي	[93d829df-eea7-416b-95aa-7593828cfade]	{'النتيجة': {'المعرف': 8، 'الاسم': 'مكتمل'}}	303299
2	8a78dce4-998a-4e81-902c-9f3957cebc9d	460	1	00:13:30.202	13	30	سال لعابه	23	شالكه 04	اللعب العادي	شالكه 04	دانيال كاليجيوري	الجناح الأيمن	[99.5، 68.1]	0.007309	حقيقي	[772c5aae-e34e-4364-8a98-7caf7636c90b]	{'النتيجة': {'المعرف': 9، 'الاسم': 'غير مكتمل'}}	303299
3	e44d0122-2f2e-4771-820d-cc326a8b0379	496	1	00:14:10.135	14	10	سال لعابه	24	شالكه 04	من رمي في	شالكه 04	سوات سردار	خط الوسط الدفاعي الأيسر	[41.2، 31.7]	0.000000	حقيقي	[4de4039f-7efc-461b-b7d6-27c32ec2cd2a]	{'النتيجة': {'المعرف': 8، 'الاسم': 'مكتمل'}}	303299
4	9555afbd-d838-42c9-8f80-be3cd09e4c4a	793	1	00:20:18.409	20	18	سال لعابه	33	اينتراخت فرانكفورت	اللعب العادي	اينتراخت فرانكفورت	تيموثي تشاندلر	ظهير أيمن	[81.8، 75.7]	0.000000	حقيقي	[a5c88cee-6319-4c25-91cd-8a028d8dbfbf]	{'النتيجة': {'المعرف': 9، 'الاسم': 'غير مكتمل'}}	303299

360 مقاييس

إذا كان لديك حق الوصول إلى بيانات 360 لمسابقة ما، فيمكنك تعيين include_360_metrics=True في وظائف events() و competition_events() لاسترداد مقياس 360 مثل تمريرة كسر الأسطر مع بيانات الحدث.

لا تتضمن البيانات المفتوحة مقاييس 360. هذا متاح حاليًا فقط للعملاء الذين لديهم اشتراك بيانات.

 events = sb.events(match_id=3837323, include_360_metrics=True)
comp_events = sb.competition_events(
            country="Europe",
            division="Champions League",
            season="2022/2023",
            include_360_metrics=True,
)
comp_events

	50_50	بطاقة_السلوك_السيء	ball_receipt_exceeds_distance	ball_receipt_in_space	ball_receipt_outcome	ball_recovery_offensive	ball_recovery_recovery_failure	block_deflection	block_offensive	block_save_block	تحمل_end_location	Clear_aerial_won	Clear_body_part	Clear_head	Clear_left_foot	Clear_other	Clear_right_foot	مكافحة الضغط	distance_to_nearest_defender	dribble_no_touch	dribble_nutmeg	dribble_outcome	dribble_overrun	Duel_outcome	Duel_type	مدة	خطأ_ملتزم_ميزة	بطاقة_خطأ_ملتزم بها	خطأ_مرتكب_هجومي	خطأ_مرتكب_عقوبة	نوع_خطأ_ملتزم	foul_won_advantage	foul_won_defensive	خطأ_وون_عقوبة	حارس_الجسم_جزء	حارس المرمى_end_location	goal_lost_in_play	goal_lost_out	goal_outcome	حارس المرمى_موقف	goal_punched_out	goal_shot_saved_off_target	لقطة_حارس_تم الحفظ_إلى_النشر	حارس المرمى_النجاح_في_اللعب	goal_technique	حارس المرمى_نوع	half_start_late_video_start	بطاقة تعريف	فِهرِس	إصابة_توقف_في_سلسلة	Interception_outcome	line_breaking_pass	موقع	دقيقة	Miscontrol_aerial_won	num_defenders_on_goal_side_of_actor	obv_against_after	obv_against_before	obv_against_net	obv_for_after	obv_for_before	obv_for_net	obv_total_net	off_camera	خارج	pass_aerial_won	pass_angle	pass_assisted_shot_id	pass_body_part	pass_cross	pass_cut_back	pass_deflected	pass_end_location	pass_goal_assist	pass_height	pass_inswinging	pass_length	pass_miscommunication	pass_no_touch	pass_outcome	pass_outswinging	pass_recipient	pass_shot_assist	pass_straight	pass_switch	pass_technique	pass_through_ball	pass_type	pass_xclaim	فترة	play_pattern	لاعب	player_id	player_off_permanent	موضع	تملُّك	حيازة_فريق	حيازة_فريق_id	ذات الصلة_الأحداث	ثانية	shot_aerial_won	shot_body_part	shot_deflected	shot_end_location	shot_first_time	shot_freeze_frame	shot_key_pass_id	shot_one_on_one	shot_open_goal	shot_outcome	shot_redirect	shot_saved_off_target	shot_saved_to_post	shot_statsbomb_xg	shot_statsbomb_xg2	shot_technique	shot_type	substitution_outcome	substitution_replacement	فريق	الطابع الزمني	يكتب	under_pressure	visual_opponents	visual_teamزملاء
0	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	0.0	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	3479244f-8234-43c9-a389-4ce587062b48	1	نان	نان	نان	نان	0	نان	نان	لا أحد	لا أحد	لا أحد	لا أحد	لا أحد	لا أحد	لا أحد	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	1	اللعب العادي	نان	نان	نان	نان	1	ريال مدريد	220	نان	0	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	ريال مدريد	00:00:00.000	ابتداء من الحادي عشر	نان	نان	نان
1	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	0.0	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	c4f5a51b-741e-4920-ac32-02349b1f2755	2	نان	نان	نان	نان	0	نان	نان	لا أحد	لا أحد	لا أحد	لا أحد	لا أحد	لا أحد	لا أحد	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	1	اللعب العادي	نان	نان	نان	نان	1	ريال مدريد	220	نان	0	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	سلتيك	00:00:00.000	ابتداء من الحادي عشر	نان	نان	نان
2	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	0.0	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	27be67e7-fdb5-4db9-92b6-8f3214cecec4	1	نان	نان	نان	نان	0	نان	نان	لا أحد	لا أحد	لا أحد	لا أحد	لا أحد	لا أحد	لا أحد	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	1	اللعب العادي	نان	نان	نان	نان	1	يوفنتوس	224	نان	0	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	يوفنتوس	00:00:00.000	ابتداء من الحادي عشر	نان	نان	نان
3	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	0.0	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	819c381e-29c1-4f10-a6c3-acc3181cec14	2	نان	نان	نان	نان	0	نان	نان	لا أحد	لا أحد	لا أحد	لا أحد	لا أحد	لا أحد	لا أحد	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	1	اللعب العادي	نان	نان	نان	نان	1	يوفنتوس	224	نان	0	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	باريس سان جيرمان	00:00:00.000	ابتداء من الحادي عشر	نان	نان	نان
4	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	0.0	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	e6d42d87-c78a-4286-94fd-4095e9f7b16f	1	نان	نان	نان	نان	0	نان	نان	لا أحد	لا أحد	لا أحد	لا أحد	لا أحد	لا أحد	لا أحد	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	1	اللعب العادي	نان	نان	نان	نان	1	مانشستر سيتي	36	نان	0	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	نان	مانشستر سيتي	00:00:00.000	ابتداء من الحادي عشر	نان	نان	نان

360 إطارات

ستعيد وظائف الإطار بيانات إطار التجميد الأولية بزاوية 360 درجة بالإضافة إلى المنطقة المرئية لكل إطار. يتم إرجاع هذا على مستوى اللاعب بحيث يكون لديك صفوف متعددة لكل إطار/event_id.

 match_frames = sb.frames(match_id=3772072, fmt='dataframe')
comp_frames = sb.competition_frames(
    country="Germany",
    division= "1. Bundesliga",
    season="2019/2020"
)
match_frames

	ممثل	distance_from_edge_of_visible_area	events_uuid	حارس	موقع	match_id	زميل في الفريق	visual_area
0	خطأ شنيع	5.183739	065b15cc-b550-48de-9a1e-a9608d8e6c6d	خطأ شنيع	[79.14114105224532، 12.646560364129726]	3855869	خطأ شنيع	[50.8965834880119، 80.0، 55.8915648466696، 6.76382112514142، 80.0765213141343، 1.48859955554994، 113.056993108772، 80.0، 50.8965834880119، 80.0]
1	خطأ شنيع	7.784551	065b15cc-b550-48de-9a1e-a9608d8e6c6d	خطأ شنيع	[80.68650097437124, 23.040779651892883]	3855869	حقيقي	[50.8965834880119، 80.0، 55.8915648466696، 6.76382112514142، 80.0765213141343، 1.48859955554994، 113.056993108772، 80.0، 50.8965834880119، 80.0]
2	خطأ شنيع	8.873694	065b15cc-b550-48de-9a1e-a9608d8e6c6d	خطأ شنيع	[80.20033992405365، 24.695673759901382]	3855869	خطأ شنيع	[50.8965834880119، 80.0، 55.8915648466696، 6.76382112514142، 80.0765213141343، 1.48859955554994، 113.056993108772، 80.0، 50.8965834880119، 80.0]
3	خطأ شنيع	9.738309	065b15cc-b550-48de-9a1e-a9608d8e6c6d	خطأ شنيع	[82.43349155444821، 32.24426347120625]	3855869	خطأ شنيع	[50.8965834880119، 80.0، 55.8915648466696، 6.76382112514142، 80.0765213141343، 1.48859955554994، 113.056993108772، 80.0، 50.8965834880119، 80.0]
4	خطأ شنيع	11.049633	065b15cc-b550-48de-9a1e-a9608d8e6c6d	خطأ شنيع	[81.320294294838، 32.98015558905158]	3855869	حقيقي	[50.8965834880119، 80.0، 55.8915648466696، 6.76382112514142، 80.0765213141343، 1.48859955554994، 113.056993108772، 80.0، 50.8965834880119، 80.0]

الإحصائيات المجمعة

بالنسبة للعملاء، نقدم أيضًا إحصائيات مجمعة على مستويات مباراة اللاعب وموسم اللاعب وموسم الفريق.

 player_match = sb.player_match_stats(3772072)
player_season = sb.player_season_stats(competition_id=9, season_id=42)
team_match = sb.team_match_stats(3772072)
team_season = sb.team_season_stats(competition_id=9, season_id=42)

player_match

	player_match_pressures	player_match_long_balls	player_match_shot_touch_ratio	player_match_passes_into_box	player_match_pressure_duration_avg	player_match_crossing_ratio	player_match_op_f3_forward_passes	player_match_passing_ratio	معرف_الفريق	player_match_successful_passes	player_match_op_xgbuildup_per_possession	player_match_op_xgchain	player_match_op_passes_into_box	player_match_deep_progressions	player_match_turnovers	player_match_counterpressured_action_fails	player_match_passes	player_match_key_passes	player_match_dispossessions	player_match_penalties_won	player_match_through_balls	team_name	player_match_op_passes	player_match_dribbles	player_match_clearances	player_match_forward_passes	player_match_np_xg_per_shot	player_match_counterpressures	player_id	player_match_op_xa	player_match_op_xgchain_per_possession	player_match_دقائق	player_match_pressure_long_balls	player_match_op_f3_sideways_passes	player_match_dribbles_faced	player_match_np_xg	player_match_goals	player_match_op_key_passes	player_match_aerial_ratio	player_match_op_shots	player_match_successful_crosses	player_match_shots_blocked	player_match_op_f3_passes	player_match_op_assists	player_match_long_ball_ratio	account_id	player_match_np_shots	player_match_challenge_ratio	player_match_touches	player_match_pressure_regains	player_match_crosses_into_box	player_match_fouls	player_match_sideways_passes	player_match_aerials	player_match_touches_inside_box	player_match_counterpressure_duration_total	player_match_successful_aerials	player_match_box_cross_ratio	player_match_xgbuildup_per_possession	player_match_dribbled_past	player_match_pressure_duration_total	player_match_op_xgbuildup	player_match_np_shots_on_target	player_match_interceptions	player_match_counterpressure_duration_avg	player_match_xgchain_per_possession	player_match_successful_long_balls	player_match_op_f3_backward_passes	player_match_xgchain	player_match_tackles	player_match_assists	player_match_sp_xa	player_match_aggressive_actions	player_name	player_match_xa	match_id	player_match_passes_inside_box	player_match_possession	player_match_pressure_action_fails	player_match_crosses	player_match_fouls_won	player_match_xgbuildup	player_match_backward_passes	player_match_unpressure_long_balls	player_match_np_goals
0	نان	10	0.000000	0	نان	نان	0	0.842105	870	32	0.003191	0.105292	0	0	0	نان	38	0	0	0	0	أرمينيا بيليفيلد	33	0	0	9	نان	نان	9194	0.000000	0.003191	94.21667	1	0	0	0.000000	0	0	نان	0	0	0	0	0	0.600000	48	0	نان	65	0	0	0	29	0	0	نان	0	نان	0.003191	0	نان	0.105292	0	0	نان	0.003191	6	0	0.105292	0	0	0.000000	0	ستيفان أورتيجا	0.000000	3772072	0	0.491135	نان	0	0	0.105292	0	9	0
1	8.0	0	0.033333	0	0.570626	0.0	0	0.812500	870	13	0.003726	0.160582	0	1	3	0.0	16	1	3	0	0	أرمينيا بيليفيلد	10	1	1	0	0.034737	1.0	9210	0.043881	0.007299	91.90000	1	4	0	0.034737	0	1	0.285714	1	0	0	6	0	نان	48	1	1.0	30	0	0	0	10	7	5	0.327541	2	نان	0.003726	0	4.565010	0.081964	0	0	0.327541	0.007299	0	2	0.160582	1	0	0.000000	9	فابيان كلوس	0.043881	3772072	1	0.491135	0.0	1	1	0.081964	6	0	0
2	7.0	13	0.000000	1	1.795411	0.0	1	0.852941	190	58	0.017993	0.773687	0	3	0	0.0	68	1	0	0	0	يونيون برلين	60	0	2	4	نان	0.0	9164	0.000000	0.017993	94.21667	2	3	0	0.000000	0	0	0.666667	0	0	1	4	0	0.615385	48	0	1.0	122	1	0	2	51	3	0	نان	2	0.0	0.017993	0	12.567875	0.773687	0	1	نان	0.019504	8	0	0.838693	2	0	0.043227	11	كريستوفر تريميل	0.043227	3772072	0	0.508865	0.0	1	0	0.773687	13	13	0
3	3.0	4	0.013699	1	0.744943	نان	1	0.777778	870	35	0.002196	0.090022	1	1	1	0.0	45	0	1	0	0	أرمينيا بيليفيلد	40	0	1	18	0.019468	0.0	24343	0.000000	0.002196	94.21667	1	1	0	0.019468	0	0	0.000000	1	0	1	2	0	0.750000	48	1	نان	73	0	0	0	22	1	1	نان	0	0.0	0.003043	0	2.234830	0.090022	0	0	نان	0.003043	3	0	0.124760	0	0	0.000000	3	جاكوب لورسن	0.000000	3772072	0	0.491135	0.0	0	1	0.124760	5	4	0
4	14.0	6	0.000