mlb_terminal 0.0.3 → 0.0.4

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    mlb_terminal (0.0.2)
+    mlb_terminal (0.0.4)
       activesupport (~> 3.2.8)
       commander (~> 4.1.2)
       nokogiri (~> 1.5.5)

data/README.md

@@ -1,18 +1,20 @@
-# MLB Terminal
+nal
 
 Access to MLB baseball scores in the terminal.
 
 ## Overview
 
-Don't you just wish you could have a little terminal app to stream out real-time stats for a MLB baseball game? Look no further!
+Don't you just wish you could have a little terminal app to stream out real-time stats for a MLB baseball game? Look no further! _Please note, the use of this data is subjected to the terms put forth by the MLB. More information can be found here: [http://gdx.mlb.com/components/copyright.txt](http://gdx.mlb.com/components/copyright.txt). You're okay if you're using this data for individual use!_
 
 ### Syntax
 
 #### Commands
 
-* help: Display global or [command] help documentation.
-* games: Print out a list of scheduled games for the specified date
-* game: Print out play-by-play events for a specific game. Use `--pitches` to output realtime pitch trajectory data.
+To find out more about a specific command, use `mlb [command] --help` to view the appropriate documentation.
+
+* `help`: Display global or [command] help documentation.
+* `games [options]`: Print out a list of scheduled games for the specified date
+* `game [options] [game_number]`: Print out play-by-play events for a specific game. Use `--pitches` to output realtime pitch trajectory data.
 
 #### Global options
 
@@ -22,6 +24,75 @@ Don't you just wish you could have a little terminal app to stream out real-time
 
 * -t, --trace: Display backtrace when an error occurs
 
+### Data Output Format
+
+Each command outputs data in tab-separated format. When outputting data for a game in progress, the application will continue to pipe in data as it is made available.
+
+#### `games` (Game listings)
+
+1. Game index. A numbered value unique to the specified date that is referenced in the `game` command.
+2. Opposing teams. A string containing: `<Away Team> (Wins - Losses) @ <Home Team> (Wins - Losses).
+3. Starting time and status.
+4. Current score.
+
+#### `game` (Game events)
+
+1. Event time.
+2. Inning.
+3. Event number.
+4. Event description.
+
+#### `game --pitches` (Pitch events)
+
+1. Pitch time.
+2. Inning.
+3. Top/Bottom of inning.
+4. Pitcher name.
+5. Batter name.
+6. Pitch type. (S-Strike, B-Ball, X-hit)
+7. X (x). The horizontal location of the pitch as it crosses the home plate. Units: Old Gameday coordinate system
+8. Y (y). The vertical location of the pitch as it crosses the home plate. Units: Old Gameday coordinate system
+9. Start speed (start_speed). The initial speed of the pitch. Units: miles per hour
+10. End speed (end_speed). The speed measured as it crosses the home plate. Units: miles per hour
+11. Top of Strike Zone (sz_top). The distance from the ground to the top of the strike zone. Units: feet
+12. Bottom of Strike Zone (sz_bot). The distance from the ground to the bottom of the strike zone. Units: feet
+13. Horizontal movement (pfx_x). The horizontal movement of a pitch relative to a theoretical pitch thrown at the same speed with no spin-induced movement. Measured at 40 feet from the home plate. Units: inches
+14. Vertical movement (pfx_z). The vertical movement of a pitch relative to a theoretical pitch thrown at the same speed with no spin-induced movement. Measured at 40 feet from the home plate. Units: inches
+15. Horizontal pitch location at home plate (px). The horizontal location of the pitch as it crosses home plate from the perspective of the umpire. Units: feet
+16. Vertical pitch location at home plate (pz). The height of the pitch as it crosses the front of home plate. Units: feet
+17. Initial horizontal measurement for pitch (x0). Initial horizontal measurement of pitch as measured by PITCHf/x. Units: feet
+18. Initial depth measurement for pitch (y0). Initial deptch measurement of pitch as measured by PITCHf/x. Note that this is fixed per stadium and typically located around 40-50 feet from home plate. Units: feet
+19. Initial height measurement for pitch (z0). Initial height measurement of pitch as measured by PITCHf/x. Units: feet
+20. Initial x velocity (vxo). Initial velocity in the horizontal direction at the initial point. Units: feet per second
+21. Initial y velocity (vxo). Initial velocity in the depth-wise direction at the initial point. Units: feet per second
+22. Initial z velocity (vxo). Initial velocity in the vertical direction at the initial point. Units: feet per second
+23. Breaking point (break_y). The distance from the home plate in which the pitch achieved its greatest deviation from the straight line path between the release point and the front of home plate. Units: feet
+24. Breaking angle (break_angle). The angle at which the pitch crossed the front of home plate as seen by the umpire. Units: degrees
+25. Breaking length (break_length). The greatest distance between the pitch's trajectory and the straight path between release and home plate. Units: inches
+26. Pitch type (pitch_type). Pitch type as classified by the PITCHf/x system.
+  * FA = Fastball
+  * FF = Four-seam fastball
+  * FT = Two-seam fastball
+  * FC = Fastball (cutter)
+  * FS / SI / SF = Fastball (sinker, split-fingered)
+  * SL = Slider
+  * CH = Changeup
+  * CB / CU = Curveball
+  * KC = Knuckle-curve
+  * KN = Knuckleball
+  * EP = Eephus
+  * UN / XX = Unidentified
+  * PO / FO = Pitch out
+27. Pitch type confidence (type_confidence). A rating corresponding to the liklihood of the pitch type classification.
+28. Pitch zone (zone).
+29. Nasty factor (nasty). A auto-generated factor that describes the difficulty in hitting the pitch.
+30. Spin direction (spin_dir).
+31. Spin rate (spin_rate).
+32. Comments (cc).
+33. Unknown (mt).
+
+For more information regarding PITCHf/x tracjectory data, please visit [http://fastballs.wordpress.com/category/pitchfx-glossary/](http://fastballs.wordpress.com/category/pitchfx-glossary/).
+
 ### Examples
 
     > # List todays games

data/bin/mlb

@@ -10,7 +10,7 @@ program :description, 'Stream MLB games into the terminal'
  
 command :games do |c|
   c.syntax = 'mlb games [options] [date]'
-  c.summary = 'Print out a list of scheduled games for the specified date'
+  c.summary = 'Print out a list of scheduled games for the specified date.'
   c.description = 'Print out a tab-seperated value list to STDOUT wih columns ' \
                   'for index, team names, game status, and current score.'
   c.example 'description', 'mlb --date "2012-09-28" | grep Nationals'
@@ -30,6 +30,97 @@ command :games do |c|
   end
 end
 
+command :pitchers do |c|
+  c.syntax = 'mlb pitchers [options] [game-number]'
+  c.summary = 'Print out a list of pitchers for the specified date and game index.'
+  c.description = 'Print out a tab-seperated value list to STDOUT wih columns ' \
+                  'for team, pitcher id, and pitcher name. Note, this prints out ' \
+                  'the full line-up on the team.'
+  c.example 'description', 'mlb pitchers 11 | grep "Edwin Jackson"'
+  c.option '--date STRING', String, 'List pitchers for specified date (Default: today)'
+  c.action do |args, options|
+    options.default :date => Time.now.to_date.to_s
+
+    # Validate input
+    if (Float(args.first) rescue nil).nil?
+      puts "Error: Game number must be a valid integer"
+      break
+    elsif (args.first.to_i < 0)
+      puts "Error: Game number must be greater than or equal to 0"
+      break
+    end
+
+    game_number = args.first.to_i
+
+    gameday_id = MLBTerminal::Game.list(Date.parse options.date)[game_number][:game_id]
+
+    MLBTerminal::Pitcher.list(gameday_id).each_pair do |pitcher_id, pitcher_info|
+      puts [
+        pitcher_info[:team],
+        pitcher_id,
+        pitcher_info[:name]].join("\t")
+    end
+  end
+end
+
+command :pitcher do |c|
+  c.syntax = 'mlb pitcher [options] [game-number] [pitcher-id]'
+  c.summary = 'Print out a list of summary statistics for pitcher tendencies.'
+  c.description = 'Print out a tab-seperated value list to STDOUT wih columns ' \
+                  'for pitcher name, pitcher team, date, away team, home team, ' \
+                  'pitch count, average speed, pitch type, pitch count, average ' \
+                  'movement, pfx, velocity, average initial x-position, and ' \
+                  'average initial z-position.'
+  c.example 'description', 'mlb pitchers --date 2012-09-30 11 | grep "Ross Detwiler" ' \
+            '| cut -f 2 | xargs mlb pitcher --date 2012-09-30 11'
+  c.option '--date STRING', String, 'List pitchers for specified date (Default: today)'
+  c.action do |args, options|
+    game_number, pitcher_id = args
+    options.default :date => Time.now.to_date.to_s
+
+    # Validate input
+    if (Float(game_number) rescue nil).nil?
+      puts "Error: Game number must be a valid integer"
+      break
+    elsif (game_number.to_i < 0)
+      puts "Error: Game number must be greater than or equal to 0"
+      break
+    end
+
+    if (Float(pitcher_id) rescue nil).nil?
+      puts "Error: Pitcher ID must be a valid integer"
+      break
+    elsif (pitcher_id.to_i < 0)
+      puts "Error: Pitcher ID must be greater than or equal to 0"
+      break
+    end
+
+    game_number = game_number.to_i
+    games = MLBTerminal::Game.list(Date.parse options.date)
+    gameday_id = games[game_number][:game_id]
+    pitcher = MLBTerminal::Pitcher.new(gameday_id, pitcher_id)
+
+    pitcher.pitch_tendency_history.each do |game|
+      game_info = MLBTerminal::Game.parse_gameday_id(game[:gameday_id])
+      puts [
+        game[:pitcher_name],
+        game[:pitcher_team],
+        Date.new(game_info[:year].to_i, game_info[:month].to_i, game_info[:day].to_i),
+        MLBTerminal::TEAMS[game_info[:away_team].to_sym],
+        MLBTerminal::TEAMS[game_info[:home_team].to_sym],
+        game[:pitch_count],
+        game[:avg_speed],
+        game[:pitch_type],
+        game[:pitch_number],
+        game[:movement],
+        game[:pfx],
+        game[:vel],
+        game[:avg_x0],
+        game[:avg_z0]].join("\t")
+    end
+  end
+end
+
 command :game do |c|
   c.syntax = 'mlb game [options] [game-number]'
   c.summary = 'Print game events'

data/lib/mlb_terminal.rb

@@ -1,2 +1,4 @@
+require 'mlb_terminal/globals'
 require 'mlb_terminal/version'
 require 'mlb_terminal/game'
+require 'mlb_terminal/pitcher'

data/lib/mlb_terminal/game.rb

@@ -4,7 +4,6 @@ require 'open-uri'
 require 'active_support/core_ext/integer/inflections'
 
 module MLBTerminal
-  MLB_BASE_URL = 'http://gd2.mlb.com/components/game/mlb'
 
   class Game
     def self.list(date = Time.now.to_date)
@@ -31,9 +30,7 @@ module MLBTerminal
     end
 
     def initialize(gameday)
-      @gameday = gameday
-      year, month, day, game_name = /([0-9]{4})_([0-9]{2})_([0-9]{2})_(.*)/.match(@gameday).to_a.slice(1,4)
-      @base_url = "#{Game.base_url_for_date(Date.new(year.to_i, month.to_i, day.to_i))}/gid_#{@gameday}"
+      @base_url = Game.parse_gameday_id_to_url gameday
     end
 
     def events(delay = 5, &block)
@@ -59,9 +56,8 @@ module MLBTerminal
 
           last_atbat = doc.xpath("//game/inning/*/atbat/@num").map(&:value).map(&:to_i).max
 
-          sleep delay
-
           if doc.xpath("//game").first["ind"] != "F"
+            sleep delay
             doc = Nokogiri::HTML(open "#{@base_url}/inning/inning_all.xml")
           end
         end while game_status != "F"
@@ -125,9 +121,8 @@ module MLBTerminal
 
           last_pitch = doc.xpath("//game/inning/*/*/pitch/@id").map(&:value).map(&:to_i).max
 
-          sleep delay
-
           if doc.xpath("//game").first["ind"] != "F"
+            sleep delay
             doc = Nokogiri::HTML(open "#{@base_url}/inning/inning_all.xml")
           end
         end while game_status != "F"
@@ -138,6 +133,21 @@ module MLBTerminal
       "#{MLB_BASE_URL}/year_#{date.year}/month_#{"%02d" % date.month}/day_#{"%02d" % date.day}"
     end
 
+    def self.parse_gameday_id_to_url(gameday)
+      game_info = Game.parse_gameday_id gameday
+      "#{Game.base_url_for_date(Date.new(game_info[:year].to_i, game_info[:month].to_i, game_info[:day].to_i))}/gid_" \
+        "#{game_info[:year]}_" \
+        "#{game_info[:month]}_" \
+        "#{game_info[:day]}_" \
+        "#{game_info[:away_team]}mlb_" \
+        "#{game_info[:home_team]}mlb_" \
+        "#{game_info[:game_number]}"
+    end
+
+    def self.parse_gameday_id(gameday)
+      Hash[[:year, :month, :day, :away_team, :home_team, :game_number].zip(/[gid_]*([0-9]{4})_([0-9]{2})_([0-9]{2})_([a-z]{3})mlb_([a-z]{3})mlb_([0-9])/.match(gameday).to_a.slice(1,6))]
+    end
+
     private
 
     def player_lookup

data/lib/mlb_terminal/globals.rb

@@ -0,0 +1,57 @@
+module MLBTerminal
+
+  MLB_BASE_URL = 'http://gd2.mlb.com/components/game/mlb'
+
+  TEAMS = {
+    :ana => "Los Angeles Angels",
+    :ari => "Arizona Diamondbacks",
+    :atl => "Atlanta Braves",
+    :bal => "Baltimore Orioles",
+    :bos => "Boston Red Sox",
+    :cha => "Chicago White Sox",
+    :chn => "Chicago Cubs",
+    :cin => "Cincinnati Reds",
+    :cle => "Cleveland Indians",
+    :col => "Colorado Rockies",
+    :det => "Detroit Tigers",
+    :hou => "Houston Astros",
+    :kca => "Kansas City Royals",
+    :lan => "Los Angeles Dodgers",
+    :mia => "Miami Marlins",
+    :mil => "Milwaukee Brewers",
+    :min => "Minnesota Twins",
+    :nya => "New York Yankees",
+    :nyn => "New York Mets",
+    :oak => "Oakland Athletics",
+    :phi => "Philadelphia Phillies",
+    :pit => "Pittsburgh Pirates",
+    :sdn => "San Diego Padres",
+    :sea => "Seattle Mariners",
+    :sfn => "San Francisco Giants",
+    :sln => "Saint Louis Cardinals",
+    :tba => "Tampa Bay Rays",
+    :tex => "Texas Rangers",
+    :tor => "Toronto Blue Jays",
+    :was => "Washington Nationals"}
+
+  PITCH_TYPES = {
+    "FA" => "Fastball",
+    "FF" => "Four-seam Fastball",
+    "FT" => "Two-seam Fastball",
+    "FC" => "Fastball / Cutter",
+    "FS" => "Fastball / Sinker",
+    "SI" => "Sinker",
+    "SF" => "Split-Fingered Fastball",
+    "SL" => "Slider",
+    "CH" => "Changeup",
+    "CB" => "Curveball",
+    "CU" => "Curveball",
+    "KC" => "Kunckle-curve",
+    "KN" => "Kunckleball",
+    "EP" => "Eephus",
+    "UN" => "Unidentified",
+    "XX" => "Unidentified",
+    "PO" => "Pitch out",
+    "FO" => "Pitch out"}
+
+end

data/lib/mlb_terminal/pitcher.rb

@@ -0,0 +1,44 @@
+require 'nokogiri'
+require 'open-uri'
+
+module MLBTerminal
+  class Pitcher
+
+    def self.list(gameday)
+      base_url = MLBTerminal::Game.parse_gameday_id_to_url gameday
+      doc = Nokogiri::HTML(open( "#{base_url}/players.xml"))
+      Hash[doc.xpath("//game/team/player[@position='P']").map{|x| [x["id"], {:team => x.xpath("..").first["name"], :name => "#{x["first"]} #{x["last"]}"}]}]
+    end
+
+    def initialize(gameday, pitcher_id)
+      @base_url = "#{MLBTerminal::Game.parse_gameday_id_to_url gameday}/premium/pitchers/#{pitcher_id}"
+      pitcher = Pitcher.list(gameday)[pitcher_id]
+      @team = pitcher[:team]
+      @name = pitcher[:name]
+    end
+
+    def pitch_tendency_history(&block)
+      doc = Nokogiri::HTML(open( "#{@base_url}/pitchtendencies_history.xml"))
+
+      Enumerator.new do |y|
+        doc.xpath("//pitchtendencies/games/game").each do |game|
+          game.xpath("types/type").each do |type|
+            y.yield({
+              :pitcher_name => @name,
+              :pitcher_team => @team,
+              :gameday_id => game["id"],
+              :pitch_count => game["num"],
+              :avg_speed => game["vel"],
+              :pitch_type => PITCH_TYPES[type["id"]],
+              :pitch_number => type["num"],
+              :movement => type["movement"],
+              :pfx => type["pfx"],
+              :vel => type["vel"],
+              :avg_x0 => type["avg_x0"],
+              :avg_z0 => type["avg_z0"] })
+          end
+        end
+      end.each(&block)
+    end
+  end
+end

data/lib/mlb_terminal/version.rb

@@ -1,3 +1,3 @@
 module MLBTerminal
-  VERSION = "0.0.3"
+  VERSION = "0.0.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mlb_terminal
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.4
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-09-30 00:00:00.000000000 Z
+date: 2012-10-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: commander
@@ -77,6 +77,8 @@ files:
 - bin/mlb
 - lib/mlb_terminal.rb
 - lib/mlb_terminal/game.rb
+- lib/mlb_terminal/globals.rb
+- lib/mlb_terminal/pitcher.rb
 - lib/mlb_terminal/version.rb
 - mlb_terminal.gemspec
 homepage: https://github.com/slnovak/mlb_terminal