statsbombpy
1.14.0
StatsBomb에서 제공하는 이 저장소는 사용자가 API에 대한 로그인 자격 증명이나 GitHub 페이지의 무료 데이터를 사용하여 StatsBomb 데이터를 Python으로 쉽게 스트리밍할 수 있는 Python 패키지입니다. API 액세스는 유료 고객만을 위한 것입니다.
pip install statsbombpy
nose2 -v --pretty-assert
로그인 자격 증명에 SB_USERNAME 및 SB_PASSWORD 라는 환경 변수를 설정하여 인증을 수행할 수 있습니다.
또는 환경 변수를 사용하지 않으려는 경우 모든 함수는 creds 인수를 허용하여 {"user": "", "passwd": ""} 형식으로 로그인 자격 증명을 전달합니다.
환경 변수 SB_CORES 사용하려는 숫자로 설정하여 sb.competition_events() 및 sb.competition_frames() 함수를 실행할 때 사용할 컴퓨터 코어 수를 지정할 수 있습니다. statsbombpy가 더 많은 코어를 사용하도록 허용하면 해당 기능의 속도가 빨라집니다.
환경 변수 세트가 없으면 시스템의 코어 수를 감지하고 해당 수보다 적은 2개를 사용합니다. 코어 수를 감지할 수 없으면 숫자를 4로 설정합니다.
StatsBomb의 공개 데이터는 인증 없이도 접근이 가능합니다.
StatsBomb은 축구 경기에 대한 이해를 높이기 위해 새로운 데이터와 연구를 공개적으로 공유하기 위해 최선을 다하고 있습니다. 우리는 모든 수준에서 새로운 연구와 분석을 적극적으로 장려하고 싶습니다. 따라서 우리는 연구 프로젝트와 축구 분석에 대한 진정한 관심을 위해 공개적으로 사용할 수 있도록 특정 리그의 StatsBomb 데이터를 무료로 제공했습니다.
StatsBomb은 데이터를 무료로 제공함으로써 더 넓은 축구 분석 커뮤니티를 확장하고 업계에 새로운 인재를 유치할 수 있기를 바라고 있습니다. 우리는 데이터 사용자에 대한 몇 가지 기본적인 개인 정보를 수집하고 싶습니다. 귀하의 이메일 주소를 제공한다는 것은 더 많은 데이터, 튜토리얼 및 연구가 제공될 때 귀하에게 알려준다는 의미입니다. 당사는 개인정보 보호정책 및 GDPR에 따라 정보를 저장합니다.
우리는 데이터를 공유하고 연구를 촉진하는 데 열중하고 있지만 여러분도 데이터에 대한 책임을 지실 것을 촉구합니다. https://www.statsbomb.com/resource-centre에 세부 정보를 등록하고 사용자 계약을 주의 깊게 읽으십시오. 이 저장소를 사용하면 사용자 계약에 동의하는 것입니다. 이 데이터를 기반으로 한 연구, 분석 또는 통찰력을 게시, 공유 또는 배포하는 경우 데이터 소스를 StatsBomb로 명시하고 당사 로고를 사용하십시오.
from statsbombpy import sb
sb.competitions()
| 경쟁_ID | 시즌_ID | 국가_이름 | 대회_이름 | 경쟁_성별 | 시즌_이름 | 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. HNL | 남성 | 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 | 킥오프 | 경쟁 | 계절 | 홈_팀 | 어웨이_팀 | home_score | 원정_점수 | match_status | 마지막_업데이트 | match_week | 경쟁_단계 | 경기장 | 심판 | home_managers | 멀리_관리자 | 데이터_버전 | 샷_피델리티_버전 | 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 | 정규시즌 | 벨틴스-아레나 | F. 즈웨이어 | 데이비드 와그너 | 아디 휘터 | 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 | 정규시즌 | 코메르츠방크 아레나 | F. 빌렌보르그 | 아디 휘터 | 프리드헬름 펑켈 | 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 | 정규시즌 | 폭스바겐 아레나 | F. 브리치 | 올리버 글라스너 | 마르코 로즈 | 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 | 정규시즌 | 올림피아스타디온 베를린 | F. 빌렌보르그 | 위르겐 클린스만 | 크리스티안 스트라이히 | 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 | 정규시즌 | 알리안츠 아레나 | C. 딩거 | 한스-디터 플릭 | 올리버 글라스너 | 1.1.0 | 2 | 2 |
sb.lineups(match_id=303299)["Eintracht Frankfurt"]
| 플레이어_ID | 플레이어_이름 | 플레이어_닉네임 | 생년월일 | 플레이어_성별 | 플레이어_키 | 플레이어_체중 | 저지_번호 | 국가 | |
|---|---|---|---|---|---|---|---|---|---|
| 0 | 3204 | 알마미 투레 | 없음 | 1996-04-28 | 남성 | 182.0 | 72.0 | 18 | 말리 |
| 1 | 5591 | 필립 코스티치 | 없음 | 1992-11-01 | 남성 | 184.0 | 82.0 | 10 | 세르비아 |
| 2 | 7713 | 오비테 에반 엔디카 | 에반 엔디카 | 1999-08-20 | 남성 | 190.0 | NaN | 2 | 프랑스 |
| 3 | 8307 | 마틴 힌터레거 | 없음 | 1992-09-07 | 남성 | 184.0 | 83.0 | 13 | 오스트리아 |
| 4 | 8669 | 미자트 가치노비치 | 없음 | 1995-02-08 | 남성 | 175.0 | 66.0 | 11 | 세르비아 |
이벤트 쿼리에 대한 기본 설정은 모든 이벤트 유형 및 이벤트 속성이 포함된 단일 데이터 프레임을 반환합니다.
events = sb.events(match_id=303299)
| ball_receipt_outcome | ball_recovery_offensive | ball_recovery_recovery_failure | block_deflection | carry_end_location | 통관_항공_원 | 클리어런스_바디_파트 | 통관_머리 | 통관_왼쪽_발 | 통관_오른쪽_발 | 반압하다 | dribble_no_touch | 드리블_결과 | 드리블 오버런 | 결투 결과 | 결투 유형 | 지속 | 파울_커밋_이점 | 파울_커밋_카드 | 파울_원_이점 | 파울_원_방어 | 골키퍼_신체_부분 | goalkeeper_end_location | 골키퍼_결과 | 골키퍼_위치 | 골키퍼_기술 | 골키퍼_유형 | ID | 색인 | 부상_정지_체인_중 | 차단_결과 | 위치 | match_id | 분 | 오프_카메라 | 밖으로 | pass_aerial_won | 통과 각도 | pass_assisted_shot_id | 패스_바디_파트 | 패스_크로스 | 통과_컷_백 | 통과_편향 | 통과_끝_위치 | 패스_골_어시스트 | 통과 높이 | 패스_길이 | 합격_결과 | 패스_아웃스윙 | 패스_수신자 | 패스_샷_지원 | 패스_스트레이트 | 패스_스위치 | 패스_기술 | 통과_공 | 패스_유형 | pass_xclaim | 기간 | 플레이_패턴 | 플레이어 | 위치 | 소유 | 소유_팀 | 관련_이벤트 | 두번째 | Shot_aerial_won | 샷_바디_파트 | 샷_끝_위치 | 촬영_첫_시간 | Shot_freeze_frame | Shot_key_pass_id | Shot_one_on_one | 샷_결과 | Shot_statsbomb_xg | Shot_statsbomb_xg2 | 샷_기술 | 샷_유형 | 대체_결과 | 대체_교체 | 팀 | 타임스탬프 | 유형 | 저압력 | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 500 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 3.498736 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 84828c06-41b5-44eb-aa92-1710bdb818ac | 1838년 | NaN | NaN | [50.1, 16.6] | 303299 | 47 | NaN | NaN | NaN | 2.720095 | NaN | 왼발 | NaN | NaN | NaN | [13.3, 33.1] | NaN | 지상 패스 | 40.329765 | NaN | NaN | 프레데릭 론나우 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 2 | 정규 플레이 | 오비테 에반 엔디카 | 왼쪽 센터백 | 103 | 아인트라흐트 프랑크푸르트 | [ae3094e3-faa3-4608-8284-d9b8cca77711, c1202f1c-0831-4e88-83b2-597f56f0c858] | 52 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 아인트라흐트 프랑크푸르트 | 00:02:52.438 | 통과하다 | 진실 |
| 501 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 3.604236 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 9061cd20-513b-499f-b925-f1de5f241281 | 1840년 | NaN | NaN | [13.3, 33.1] | 303299 | 47 | NaN | NaN | NaN | -0.153945 | NaN | 오른발 | NaN | NaN | NaN | [77.1, 23.2] | NaN | 하이패스 | 64.563540 | 불완전한 | NaN | 미자트 가치노비치 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 2 | 정규 플레이 | 프레데릭 론나우 | 골키퍼 | 103 | 아인트라흐트 프랑크푸르트 | [8e6495a7-782a-4f1a-845f-3ec50d761a1e, ff758a12-1ba6-4dd4-8b2c-7d39aa7aed97] | 55 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 아인트라흐트 프랑크푸르트 | 00:02:55.937 | 통과하다 | NaN |
| 502 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 1999년 2월 10일 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 8e6495a7-782a-4f1a-845f-3ec50d761a1e | 1842년 | NaN | NaN | [43.0, 56.9] | 303299 | 47 | NaN | NaN | NaN | -0.703110 | NaN | 머리 | NaN | NaN | NaN | [64.0, 39.1] | NaN | 하이패스 | 27.528894 | NaN | NaN | 아민 하릿 | NaN | NaN | NaN | NaN | NaN | 회복 | NaN | 2 | 정규 플레이 | 오잔 무하메드 카박 | 오른쪽 센터백 | 104 | 샬케 04 | [9061cd20-513b-499f-b925-f1de5f241281, be6dfe7d-7596-4cc2-8cd9-8c17d064317e] | 59 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 샬케 04 | 00:02:59.541 | 통과하다 | NaN |
| 503 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 1.187459 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 86431bc7-210a-4868-8e18-26ff38becefc | 1854년 | NaN | NaN | [65.9, 12.6] | 303299 | 48 | NaN | NaN | NaN | -0.730239 | NaN | 오른발 | NaN | NaN | NaN | [74.5, 4.9] | NaN | 지상 패스 | 11.543396 | NaN | NaN | 아민 하릿 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 2 | 정규 플레이 | 수아트 세르다르 | 왼쪽 수비형 미드필더 | 104 | 샬케 04 | [761b4e65-8f64-464c-8153-6a98465208ba] | 7 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 샬케 04 | 00:03:07.689 | 통과하다 | NaN |
| 504 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 0.766628 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 6e58c713-622c-4246-8243-e4162e487a1c | 1858년 | NaN | NaN | [79.1, 10.5] | 303299 | 48 | NaN | NaN | NaN | 1.254940 | NaN | 오른발 | NaN | NaN | NaN | [84.1, 25.8] | NaN | 지상 패스 | 16.096273 | NaN | NaN | 랍비 마톤도 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 2 | 정규 플레이 | 아민 하릿 | 중앙 공격형 미드필더 | 104 | 샬케 04 | [b1960a76-d3ae-4ef3-a2cd-47eca8c25e0a, dd1575c0-a408-4177-944d-7e86d2f79181] | 11 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 샬케 04 | 00:03:11.719 | 통과하다 | 진실 |
각 이벤트 유형에 대해 고유한 데이터프레임을 가져오거나 자체 열에 고유한 이벤트 속성을 갖는 것도 가능합니다.
sb.events(match_id=303299, split=True, flatten_attrs=False)["dribbles"]
| ID | 색인 | 기간 | 타임스탬프 | 분 | 두번째 | 유형 | 소유 | 소유_팀 | 플레이_패턴 | 팀 | 플레이어 | 위치 | 위치 | 지속 | 저압력 | 관련_이벤트 | 드리블 | 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] | {'결과': {'id': 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] | {'결과': {'id': 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] | {'결과': {'id': 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] | {'결과': {'id': 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] | {'결과': {'id': 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"]
| ID | 색인 | 기간 | 타임스탬프 | 분 | 두번째 | 유형 | 소유 | 소유_팀 | 플레이_패턴 | 팀 | 플레이어 | 위치 | 위치 | 지속 | 저압력 | 관련_이벤트 | 드리블 | 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] | {'결과': {'id': 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] | {'결과': {'id': 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] | {'결과': {'id': 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] | {'결과': {'id': 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] | {'결과': {'id': 9, '이름': '불완전'}} | 303299 |
대회에 대한 360 데이터에 액세스할 수 있는 경우 events() 및 competition_events() 함수에서 include_360_metrics=True 설정하여 이벤트 데이터와 함께 라인 브레이크 패스와 같은 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 | carry_end_location | 통관_항공_원 | 클리어런스_바디_파트 | 통관_머리 | 통관_왼쪽_발 | 통관_기타 | 통관_오른쪽_발 | 반압하다 | distance_to_nearest_defender | dribble_no_touch | 드리블_육두구 | 드리블_결과 | 드리블 오버런 | 결투 결과 | 결투 유형 | 지속 | 파울_커밋_이점 | 파울_커밋_카드 | 파울_커밋_공격 | 파울_범_페널티 | 파울_커밋_유형 | 파울_원_이점 | 파울_원_방어 | 파울_원_페널티 | 골키퍼_신체_부분 | goalkeeper_end_location | goalkeeper_lost_in_play | goalkeeper_lost_out | 골키퍼_결과 | 골키퍼_위치 | goalkeeper_punched_out | goalkeeper_shot_saved_off_target | goalkeeper_shot_saved_to_post | goalkeeper_success_in_play | 골키퍼_기술 | 골키퍼_유형 | half_start_late_video_start | ID | 색인 | 부상_정지_체인_중 | 차단_결과 | 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 | 오프_카메라 | 밖으로 | pass_aerial_won | 통과 각도 | pass_assisted_shot_id | 패스_바디_파트 | 패스_크로스 | 통과_컷_백 | 통과_편향 | 통과_끝_위치 | 패스_골_어시스트 | 통과 높이 | 패스_인스윙 | 패스_길이 | 통과_잘못된 통신 | pass_no_touch | 합격_결과 | 패스_아웃스윙 | 패스_수신자 | 패스_샷_지원 | 패스_스트레이트 | 패스_스위치 | 패스_기술 | 통과_공 | 패스_유형 | pass_xclaim | 기간 | 플레이_패턴 | 플레이어 | 플레이어_ID | player_off_permanent | 위치 | 소유 | 소유_팀 | 보유_팀_ID | 관련_이벤트 | 두번째 | Shot_aerial_won | 샷_바디_파트 | 사격_편향 | 샷_끝_위치 | 촬영_첫_시간 | Shot_freeze_frame | Shot_key_pass_id | Shot_one_on_one | Shot_open_goal | 샷_결과 | 샷_리디렉션 | Shot_saved_off_target | Shot_saved_to_post | Shot_statsbomb_xg | Shot_statsbomb_xg2 | 샷_기술 | 샷_유형 | 대체_결과 | 대체_교체 | 팀 | 타임스탬프 | 유형 | 저압력 | 보이는 상대 | visible_teammates | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 0 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 0.0 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 3479244f-8234-43c9-a389-4ce587062b48 | 1 | NaN | NaN | NaN | NaN | 0 | NaN | NaN | 없음 | 없음 | 없음 | 없음 | 없음 | 없음 | 없음 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 1 | 정규 플레이 | NaN | NaN | NaN | NaN | 1 | 레알 마드리드 | 220 | NaN | 0 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 레알 마드리드 | 00:00:00.000 | XI 시작 | NaN | NaN | NaN |
| 1 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 0.0 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | c4f5a51b-741e-4920-ac32-02349b1f2755 | 2 | NaN | NaN | NaN | NaN | 0 | NaN | NaN | 없음 | 없음 | 없음 | 없음 | 없음 | 없음 | 없음 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 1 | 정규 플레이 | NaN | NaN | NaN | NaN | 1 | 레알 마드리드 | 220 | NaN | 0 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 켈트 말 | 00:00:00.000 | XI 시작 | NaN | NaN | NaN |
| 2 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 0.0 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 27be67e7-fdb5-4db9-92b6-8f3214cecec4 | 1 | NaN | NaN | NaN | NaN | 0 | NaN | NaN | 없음 | 없음 | 없음 | 없음 | 없음 | 없음 | 없음 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 1 | 정규 플레이 | NaN | NaN | NaN | NaN | 1 | 유벤투스 | 224 | NaN | 0 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 유벤투스 | 00:00:00.000 | XI 시작 | NaN | NaN | NaN |
| 3 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 0.0 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 819c381e-29c1-4f10-a6c3-acc3181cec14 | 2 | NaN | NaN | NaN | NaN | 0 | NaN | NaN | 없음 | 없음 | 없음 | 없음 | 없음 | 없음 | 없음 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 1 | 정규 플레이 | NaN | NaN | NaN | NaN | 1 | 유벤투스 | 224 | NaN | 0 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 파리 생제르맹 | 00:00:00.000 | XI 시작 | NaN | NaN | NaN |
| 4 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 0.0 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | e6d42d87-c78a-4286-94fd-4095e9f7b16f | 1 | NaN | NaN | NaN | NaN | 0 | NaN | NaN | 없음 | 없음 | 없음 | 없음 | 없음 | 없음 | 없음 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 1 | 정규 플레이 | NaN | NaN | NaN | NaN | 1 | 맨체스터 시티 | 36 | NaN | 0 | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | 맨체스터 시티 | 00:00:00.000 | XI 시작 | NaN | NaN | NaN |
프레임 함수는 각 프레임의 가시 영역과 함께 원시 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 | event_uuid | 관리인 | 위치 | match_id | 팀원 | 보이는_지역 | |
|---|---|---|---|---|---|---|---|---|
| 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_press | player_match_long_balls | player_match_shot_touch_ratio | player_match_passes_into_box | player_match_press_duration_avg | player_match_crossing_ratio | player_match_op_f3_forward_passes | player_match_passing_ratio | 팀_ID | 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_counterpressiond_action_fails | player_match_passes | player_match_key_passes | player_match_dispossessions | player_match_penalties_won | player_match_through_balls | 팀_이름 | player_match_op_passes | player_match_dribbles | player_match_clearances | player_match_forward_passes | player_match_np_xg_per_shot | player_match_counterPressure | 플레이어_ID | player_match_op_xa | player_match_op_xgchain_per_possession | player_match_분 | player_match_Pressured_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_press_regains | player_match_crosses_into_box | player_match_fouls | player_match_sideways_passes | player_match_aerials | player_match_touches_inside_box | player_match_counterpresser_duration_total | player_match_successful_aerials | player_match_box_cross_ratio | player_match_xgbuildup_per_possession | player_match_dribbled_past | player_match_press_duration_total | player_match_op_xgbuildup | player_match_np_shots_on_target | player_match_interceptions | player_match_counterpresser_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_match_xa | match_id | player_match_passes_inside_box | player_match_possession | player_match_Pressured_action_fails | player_match_crosses | player_match_fouls_won | player_match_xgbuildup | player_match_backward_passes | player_match_unpressed_long_balls | player_match_np_goals | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 0 | NaN | 10 | 0.000000 | 0 | NaN | NaN | 0 | 0.842105 | 870 | 32 | 0.003191 | 0.105292 | 0 | 0 | 0 | NaN | 38 | 0 | 0 | 0 | 0 | 아르미니아 빌레펠트 | 33 | 0 | 0 | 9 | NaN | NaN | 9194 | 0.000000 | 0.003191 | 94.21667 | 1 | 0 | 0 | 0.000000 | 0 | 0 | NaN | 0 | 0 | 0 | 0 | 0 | 0.600000 | 48 | 0 | NaN | 65 | 0 | 0 | 0 | 29 | 0 | 0 | NaN | 0 | NaN | 0.003191 | 0 | NaN | 0.105292 | 0 | 0 | NaN | 0.003191 | 6 | 0 | 0.105292 | 0 | 0 | 0.000000 | 0 | 스테판 오르테가 | 0.000000 | 3772072 | 0 | 0.491135 | NaN | 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 | NaN | 48 | 1 | 1.0 | 30 | 0 | 0 | 0 | 10 | 7 | 5 | 0.327541 | 2 | NaN | 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 | NaN | 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 | NaN | 2 | 0.0 | 0.017993 | 0 | 12.567875 | 0.773687 | 0 | 1 | NaN | 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 | NaN | 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 | NaN | 73 | 0 | 0 | 0 | 22 | 1 | 1 | NaN | 0 | 0.0 | 0.003043 | 0 | 2.234830 | 0.090022 | 0 | 0 | NaN | 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 |
