メインコンテンツへスキップ
見出し画像

Baseball Savantの使い方 〜CSV取得編〜

    役に立つ方には役に立つ、役に立たない方にはこの機会に興味を持ってもらおうというだけの個人用メモです。

    ※野手ページ編はこちら。
    ※ Search 機能編はこちら。

    Baseball Savantには既に各項目の説明がまとめられたドキュメントが存在します…が、更新されていません。また、そもそも英語がわからずいちいち調べ直すのが面倒だったりします。なので日本語版としてこの記事にまとめておきます。

    ※ 2026 年 6 月 22 日更新
    公式の解説ページが大幅に更新されていました。もはやこの記事も不要な気もしてきましたが、日本語の文献がないため残しておきます。


    ◾️データ取得方法

    ①サイトから直接取得する。

    「そもそも鯖のCSVデータはどこで取得できるんだ?」という方もいると思うので簡単に手順を説明しておきます。知ってる方は飛ばしてください。

    特定の条件におけるデータを手っ取り早く取得したい場合はsearchから。適当に2025年のMLBで三塁打が発生した投球のデータを取得してみます。

    画像
    画像はBaseball Savantより引用。

    赤丸で囲まれたボタンを押下。

    画像
    取得完了。

    このようなデータが取得できます。ここで出てきた各カラムの日本語訳をまとめるよってのが今回の趣旨です。

    ②Pythonで取得する。

    個人的にPython(Google Colab)を使ってるだけでRとかでも流れは大体同じなはず。本格的な分析がしたい場合はこっちがメインになると思います。手順について日本語で解説してる記事は検索すればいくつかヒットしますが、せあぶらさんのnoteがわかりやすいと思うので紹介しておきます。

    上の記事ではStep.3以降条件を絞っていますが、これを全て取得にすればいいだけ。

    画像
    取得完了2。

    先程のCSVデータと同様のカラムが取得できます。みんなこれを弄って分析してるよってことです。


    ◾️項目

    ChatGPTに解説させたものを修正しただけです。個人的によく使うものを太字で示しています。

    pitch_type - 投球の種類(例:FF=フォーシーム、SL=スライダーなど)
    game_date - 試合日
    release_speed - 投球の初速(mph)
    release_pos_x - リリース位置(横方向、捕手視点)
    release_pos_z - リリース位置(縦方向、捕手視点)
    player_name - 投手名
    batter - 打者のMLB ID
    pitcher - 投手のMLB ID
    events - 打席結果(例:home_run, strikeoutなど)
    description - 投球結果の説明(例:swinging_strike, foulなど)
    spin_dir - スピン方向(旧項目、非推奨)
    spin_rate_deprecated - スピンレート(旧方式)
    break_angle_deprecated - 変化の角度(旧方式)
    break_length_deprecated - 変化の長さ(旧方式)
    zone - ストライクゾーン上の投球位置(1〜14の番号)
    des - Gameday用の打席説明
    game_type - 試合の種類(R:レギュラーシーズンなど)
    stand - 打者の立ち位置(L/R)
    p_throws - 投手の投球腕(L/R)
    home_team - ホームチーム
    away_team - アウェイチーム
    type - 投球結果の略記(B:ボール, S:ストライク, X:インプレー)
    hit_location - 最初にボールに触れた守備位置
    bb_type - 打球タイプ(ground_ball, fly_ball など)
    balls - ボールカウント
    strikes - ストライクカウント
    game_year - 試合年
    pfx_x - 投球の横方向変化(捕手視点、フィート)
    pfx_z - 投球の縦方向変化(捕手視点、フィート)
    plate_x - プレート通過位置(横)
    plate_z - プレート通過位置(高さ)
    on_3b - 三塁ランナーのID
    on_2b - 二塁ランナーのID
    on_1b - 一塁ランナーのID
    outs_when_up - 打席時のアウトカウント
    inning - イニング数
    inning_topbot - 表か裏(Top / Bottom)
    hc_x - 打球のフィールド座標(X)
    hc_y - 打球のフィールド座標(Y)
    tfs_deprecated - Gameday関連(旧)
    tfs_zulu_deprecated - Gameday関連UTC(旧)
    umpire - 審判ID(旧項目)
    sv_id - セッション内の一意なプレイID
    vx0 - 投球のX軸初速(ft/s)
    vy0 - 投球のY軸初速(ft/s)
    vz0 - 投球のZ軸初速(ft/s)
    ax - 投球のX軸加速度(ft/s²)
    ay - 投球のY軸加速度(ft/s²)
    az - 投球のZ軸加速度(ft/s²)
    sz_top - ストライクゾーン上限(打者別)
    sz_bot - ストライクゾーン下限(打者別)
    hit_distance_sc - 打球飛距離(推定、フィート)
    launch_speed - 打球初速(Exit Velocity)
    launch_angle - 打球角度(度)
    effective_speed - 打者が感じる球速(リリース距離考慮)
    release_spin_rate - スピンレート(rpm)
    release_extension - リリース距離(ホームまでの残り距離)
    game_pk - 試合一意ID
    fielder_2〜9 - 守備位置別の選手ID(捕〜外野)
    release_pos_y - リリース位置(前後、ホームまでの距離)
    estimated_ba_using_speedangle - 速度・角度に基づく推定打率
    estimated_woba_using_speedangle - 同上の推定wOBA
    woba_value - 実測wOBA値
    woba_denom - wOBAの分母
    babip_value - 実測BABIP
    iso_value - ISO(長打率差)
    launch_speed_angle - 打球のゾーン分類(Barrel等)
    at_bat_number - 試合中の打席番号
    pitch_number - 打席中の投球番号
    pitch_name - 球種名(例:4-Seam Fastball)
    home_score - 投球前のホームスコア
    away_score - 投球前のアウェイスコア
    bat_score - 投球前の打者側スコア
    fld_score - 投球前の守備側スコア
    post_away_score - 投球後のアウェイスコア
    post_home_score - 投球後のホームスコア
    post_bat_score - 投球後の打者側スコア
    post_fld_score - 投球後の守備側スコア
    if_fielding_alignment - 内野守備隊形(シフトなど)
    of_fielding_alignment - 外野守備隊形
    spin_axis - スピン軸(0〜360度、180=バックスピン)
    delta_home_win_exp - 打席前後のホーム勝率期待値差
    delta_run_exp - 投球前後の得点期待値差
    bat_speed - バットスピード(mph)
    swing_length - スイング距離(バットの軌道長さ)
    estimated_slg_using_speedangle - 推定SLG(打球速度×角度)
    delta_pitcher_run_exp - 投手の得点期待値変化
    hyper_speed - Adjusted Exit Velocity
    home_score_diff - ホームスコア差
    bat_score_diff - 打者側スコア差
    home_win_exp - 投球前のホーム勝率期待値
    bat_win_exp - 投球前の打者側勝率期待値
    age_pit_legacy - 投手年齢(旧計算)
    age_bat_legacy - 打者年齢(旧計算)
    age_pit - 投手年齢(新計算)
    age_bat - 打者年齢(新計算)
    n_thruorder_pitcher - 投手が打順何巡目か(1〜3)
    n_priorpa_thisgame_player_at_bat - この試合でのこの打者の打席数
    pitcher_days_since_prev_game - 投手の前回登板からの日数
    batter_days_since_prev_game - 打者の前回出場からの日数
    pitcher_days_until_next_game - 投手の次回登板までの日数
    batter_days_until_next_game - 打者の次回出場までの日数
    api_break_z_with_gravity - 重力を考慮した縦変化量
    api_break_x_arm - 投手腕方向から見た横変化
    api_break_x_batter_in - 打者視点での「内側」への変化
    arm_angle - 投球時の腕の角度

    修正点あったら教えてください。


    ※画像は【Nationals MacKenzie Gore can show he is an ace today】より引用。
    ※全ての商用的、あるいは著作権侵害の意図を放棄して投稿します。


    この記事が参加している募集

    あなたへのおすすめ