statsbombpy
1.14.0
StatsBomb によって提供されるこのリポジトリは、ユーザーが API のログイン資格情報または GitHub ページからの無料データを使用して、StatsBomb データを Python に簡単にストリーミングできるようにする Python パッケージです。 API アクセスは有料顧客のみが対象です
サポート: [email protected]
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 | マッチ_利用可能 | |
|---|---|---|---|---|---|---|---|---|
| 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)
| 一致ID | 一致日 | キックオフ | 競争 | 季節 | ホームチーム | アウェイチーム | ホームスコア | アウェイスコア | マッチステータス | 最終更新日 | match_week | 競技ステージ | スタジアム | 審判 | ホームマネージャー | アウェイマネージャー | データバージョン | ショット忠実度_バージョン | 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 | レギュラーシーズン | VELTINS アリーナ | 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)
| ボール受信結果 | ボール_回復_攻撃的 | ボール_回復_回復_失敗 | ブロックたわみ | キャリー終了位置 | クリアランス_空中_獲得 | クリアランス_ボディ_パーツ | クリアランスヘッド | クリアランス_左足 | クリアランス_右足 | カウンタープレス | ドリブルノータッチ | ドリブル_結果 | ドリブルオーバーラン | 決闘結果 | デュエルタイプ | 間隔 | ファウル_コミット_アドバンテージ | ファウル_コミット_カード | ファウル・ウォン・アドバンテージ | ファウル・ウォン・ディフェンス | ゴールキーパーの体の一部 | ゴールキーパーの終了位置 | ゴールキーパー_結果 | ゴールキーパーのポジション | ゴールキーパーのテクニック | ゴールキーパーの種類 | ID | 索引 | チェーン内での負傷_停止 | 傍受_結果 | 位置 | 一致ID | 分 | オフカメラ | 外 | pass_aerial_won | パス角度 | pass_assisted_shot_id | パスボディパーツ | パスクロス | パスカットバック | pass_deflected | pass_end_location | パス_ゴール_アシスト | パスの高さ | pass_length | pass_outcome | pass_outswinging | パス受信者 | パスショットアシスト | パス_ストレート | パススイッチ | パステクニック | パススルーボール | パスタイプ | pass_xclaim | 期間 | プレイパターン | プレーヤー | 位置 | 所持 | 所有チーム | 関連イベント | 2番 | ショットエアリアルウォン | ショットボディパーツ | ショット終了場所 | ショットファーストタイム | ショットフリーズフレーム | ショットキーパスID | ショットワンオンワン | ショットの結果 | ショット統計爆弾_xg | ショット統計爆弾_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 | 2.101999 | 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 | 索引 | 期間 | タイムスタンプ | 分 | 2番 | タイプ | 所持 | 所有チーム | プレイパターン | チーム | プレーヤー | 位置 | 位置 | 間隔 | プレッシャー下 | 関連イベント | ドリブル | 一致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-8a028d8dbbfbf] | {'結果': {'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 | 索引 | 期間 | タイムスタンプ | 分 | 2番 | タイプ | 所持 | 所有チーム | プレイパターン | チーム | プレーヤー | 位置 | 位置 | 間隔 | プレッシャー下 | 関連イベント | ドリブル | 一致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-8a028d8dbbfbf] | {'結果': {'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 | bad_behaviour_card | ボール受信_距離を超える | ball_receipt_in_space | ボール受信結果 | ボール_回復_攻撃的 | ボール_回復_回復_失敗 | ブロックたわみ | ブロック攻撃的 | block_save_block | キャリー終了位置 | クリアランス_空中_獲得 | クリアランス_ボディ_パーツ | クリアランスヘッド | クリアランス_左足 | クリアランス_その他 | クリアランス_右足 | カウンタープレス | 最も近いディフェンダーまでの距離 | ドリブルノータッチ | dribble_nutmeg | ドリブル_結果 | ドリブルオーバーラン | 決闘結果 | デュエルタイプ | 間隔 | ファウル_コミット_アドバンテージ | ファウル_コミット_カード | ファウル・コミットメント・オフェンス | ファウル_コミット_ペナルティ | ファウル_コミットタイプ | ファウル・ウォン・アドバンテージ | ファウル・ウォン・ディフェンス | ファウル・ウォン・ペナルティ | ゴールキーパーの体の一部 | ゴールキーパーの終了位置 | ゴールキーパー_プレー中ロスト | ゴールキーパー_ロスト_アウト | ゴールキーパー_結果 | ゴールキーパーのポジション | ゴールキーパー_パンチアウト_ | ゴールキーパーショット_セーブ_オフ_ターゲット | ゴールキーパーショット_saved_to_post | ゴールキーパー_成功_in_play | ゴールキーパーのテクニック | ゴールキーパーの種類 | half_start_late_video_start | ID | 索引 | チェーン内での負傷_停止 | 傍受_結果 | 改行_パス | 位置 | 分 | misscontrol_aerial_won | ゴール側のアクターのディフェンダー数 | 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_deflected | pass_end_location | パス_ゴール_アシスト | パスの高さ | pass_inswinging | pass_length | pass_miscommunication | ノータッチパス | pass_outcome | pass_outswinging | パス受信者 | パスショットアシスト | パス_ストレート | パススイッチ | パステクニック | パススルーボール | パスタイプ | pass_xclaim | 期間 | プレイパターン | プレーヤー | プレイヤーID | player_off_permanent | 位置 | 所持 | 所有チーム | 所有チームID | 関連イベント | 2番 | ショットエアリアルウォン | ショットボディパーツ | ショットディフレクト | ショット終了位置 | ショットファーストタイム | ショットフリーズフレーム | ショットキーパスID | ショットワンオンワン | ショットオープンゴール | ショットの結果 | ショットリダイレクト | ショット_保存_オフ_ターゲット | ショットを投稿に保存 | ショット統計爆弾_xg | ショット統計爆弾_xg2 | ショットテクニック | ショットタイプ | 代替結果 | 置換_置換 | チーム | タイムスタンプ | タイプ | プレッシャー下 | 可視_対戦相手 | 見えるチームメイト | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 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 | スターティングイレブン | 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 | スターティングイレブン | 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 | スターティングイレブン | 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 | スターティングイレブン | 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 | スターティングイレブン | NaN | NaN | NaN |
フレーム関数は、生の 360 フリーズ フレーム データと各フレームの可視領域を返します。これはプレーヤー レベルで返されるため、frame/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
| 俳優 | 可視領域の端からの距離 | イベント_uuid | キーパー | 位置 | 一致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_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 | チームID | player_match_successed_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 | チーム名 | player_match_op_passes | player_match_dribbles | player_match_clearances | player_match_forward_passes | player_match_np_xg_per_shot | player_match_counterpressures | プレイヤーID | player_match_op_xa | player_match_op_xgchain_per_possession | player_match_ minutes | 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_successed_crosses | player_match_shots_blocked | player_match_op_f3_passes | player_match_op_assists | player_match_long_ball_ratio | アカウントID | player_match_np_shots | player_match_challenge_ratio | player_match_touches | player_match_pressure_regains | player_match_crosses_into_box | player_match_fauls | player_match_sideways_passes | player_match_aerials | player_match_touches_inside_box | player_match_counterpressure_duration_total | player_match_successed_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_successed_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 | 一致ID | player_match_passes_inside_box | player_match_possession | player_match_pressured_action_fails | player_match_crosses | player_match_fauls_won | player_match_xgbuildup | player_match_backward_passes | player_match_unpressured_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 |
