grs_instructions
This is an old revision of the document!
GRS Codes
GRS is a program for creating a game report for a Pursue the Pennant
game. It was written by Greg Speegle and Sean Sweda.
RUNNING THE PROGRAM
Usage: grs [-ahfv] [afile] [hfile] [infile] outfile
-a Used to read in the away team's lineup from an external file.
ex: grs -a yesterdays_game.cmd todays_game
-h Used to read in the home team's lineup from an external file.
ex: grs -h my_lineup_vsRH game6
-f Used to read in commands from an external file. NOTE: This
includes the lineups, thus -f is incompatible with -a and/or -h.
ex: grs -f unfinished_game 1-1
-v Using this flag will cause grs to output the version number.
(v2.3.0 and later)
If you use the -f flag to read in a file, make sure that the last
event is NOT 'eg' or 'en'.
The last operand is always the output file prefix. GRS will create
the following files:
<outfile>.sts - the stats
<outfile>.pbp - the play-by-play
<outfile>.cmd - the commands you typed in
<outfile>.un# - a file grs uses temporarily to process the undo command
there may be several of these files after you are done
The accompanying shell script, grscat (instructions at the end) will
concatenate these files into one large file, if you so desire.
WHAT IT DOESN'T DO
(hopefully this will remain blank)
ENTERING THE LINEUPS
GRS uses space dilimited text. Thus, when prompted for player name,
real team, and position, you should separate these by spaces.
Example: Whitaker DET 2b
When GRS is started, you will be prompted for a three letter team
abbreviation for each team. Please capitalize this abbreviation.
This program was created with the designated hitter in mind. If the
pitcher bats in your league, you must enter him in the original lineup
twice, once as a batter and once as a pitcher.
As noted above, lineups may be read in from an external file. If you
want to do this, make sure the lienups are in the same format as they
appear in the .cmd file.
COMMAND SYNTAX
GRS accepts commands in the following syntax: (space delimited)
event location baserunning
event - a 2 letter event code, all of which are listed below
location - many uses, eg. location of a hit (gcf), or fielding
on the play (6-3); also can be used to indicate a
special kind of play like a H&R or IFR, eg. 6-3(IFR)
or IFR(6) or lcf(H&R), etc.
baserunning - in groups of 2, indicating where the player started,
and where he ended up, eg. 12 means runner on 1st
went to second. Use the letter 'b' for the batter,
'o' for out, and 'h' for home. There are default
advances programmed in, so you can skip the
baserunning field if nobody advanced an extra base.
The location is optional for all events. Some events require baserunning
information. When entering errors, only list the player who made the
error in the location field. (e.g. er 3 b1 instead of er 6-3 b1 for a
dropped throw by the firstbaseman)
ALL GRS commands are entered in LOWER CASE.
For ALL baserunning events, make sure you list the lead runner first:
ex. sb 2312 (runner on 2nd steals 3rd and 1st steal 2nd)
This is a list of the events that the grs program accepts:
ph - pinch hit
Use the same form as lineup entry. List the position the
pinch-hitter will play next inning, or just "ph" if he
is only pinch-hitting.
Example:
ph
Ward ATL PH(enter a space here after team)
(This would Pinch Hit ATL Ward and list him as a PH in the GRS.
You would have to either insert a defensively replacement [dc]
or change his position [dc])
or
ph
Ward ATL 1b
(This would Pinch Hit ATL Ward and list him as 1b)
pr - pinch run
Use the same form as lineup entry. List the position the
pinch-runner will play next inning, or just "pr" if he
is only pinch-running.
Example:
pr <return>
Figgins LAA PR
<return> (enter a space here after team)
(This would Pinch Run LAA Figgins and list him as a Pr in the GRS.
You would have to either insert a defensively replacement [dc]
or change his position [dc])
or
pr <return>
Figgins LAA CF
<return>
(This would Pinch Hit LAA Figgins and list him as CF)
np - new pitcher
Use the same form as lineup entry. Also, if you are playing
with the pitcher batting, you can specify the position in the
batting order where the pitcher will hit, and grs will
automatically insert him into the batting order.
ex: Rivera NYA R 9 (this would put Rivera in the 9 hole)
Example:
np <return>
Rivera NYA R <return>
(This would insert NYA Rivera as the pitcher.)
or
np <return>
Rivera NYA R 7 <return>
(This would insert NYA Rivera as the pitcher, batting 7th.)
dr - defensive replacement
Use this entry to make a defensive SUBSTITUTION.
Example:
dr <return>
7 <return> - batting order
Chavez NYN CF <return>
(This would substitute NYN Chavez for the current #7 hitter and
play him in CF.)
dc - defensive position change
Use the same form as lineup entry. The only difference
between these two commands is that "dc" moves a player from
one position to another and "dr" replaces a player.
Use this entry to make a defensive SUBSTITUTION.
Example:
dc <return>
7 <return> - batting order
Chavez NYN CF <return>
(This would move NYN Chavez to CF.)
la - list the away team's lineup
lh - list the home team's lineup
un - undo
Undo will allow you to undo any event, including a lineup
change or the end of an inning. You can even undo several
events at once. Make sure that there is never an undo
command in a command file that you are reading in via the
-f flag, as the undo command is never recorded in the .cmd
file normally, and this will only serve to confuse grs.
MINIMIZE USING THIS COMMAND.
en - end of inning
eg - end of game
cm - comment
nj - enters in a "<runner> unable to get jump" comment, specify base of runner
fa - enters in a "<pitcher> fatigues" comment
so - strikeout
kd - strikeout, dropped third strike
kc - strikeout, caught stealing
ks - strikeout, stolen base
bb - walk
iw - intentional walk
ci - catcher's interference
hb, hp - hit by pitch
wp - wild pitch
pb - passed ball
bk - balk
sb - stolen base
make sure to indicate which runner(s) steal if there is more than
one runner on base
ex.
sb 12 (runner on 1st steals 2nd)
cs - caught stealing
ex.
cs 1o (runner on 1st caught stealing)
pk - picked off
ex.
pk 1-3 1o (runner on 1st picked off - pitcher to 1st)
th - advance on a throw
ex.
th 23 (runner on 2nd advances to 3rd on throw)
or
th 3h23 (runner on 3rd scores and 2nd to 3rd on throw)
oa - out advancing on a throw
ex.
oa 8-2 3o (runner on third thrown out at home by CF)
1b - single
ex.
1b gcf (single - groundball to CF)
2b - double
3b - triple
hr - home run
dp,gd - ground into double play
ex.
dp hg6 1obo (double play Hard grounder to SS, runner on 1st out at 2nd
and Batter out at 1st)
fd - fly into double play (rarely used)
ld - line into double play
ex.
ld lo6 1obo (line drive to SS, runner on first doubled up - make sure
you show BOTH players who are out on the play)
lo - line out
ex.
lo 6 (Line drive to SS, batter out)
fc - fielder's choice, batter reaches first
ex.
fc rg6 1ob1 (fielder’s choice, routine Grounder to SS runner on 1st out
at 2nd, batter safe at 1st)
hg - hard ground out
ex.
hg 5 (hard grounder to 3B, batter out at 1st)
rg - routine ground out
ex.
rg 4 (routine grounder to 2B, batter out at 1st)
sg - slow ground out
ex.
sg 3 (slow grounder to 1B, batter out at 1st)
Make sure to show any runners that advance on any out at any base.
ex.
sg 3 12 (runner on 1st advances to 2nd)
hf - high fly
ex.
hf 8 (high fly to CF)
po - pop out
ex.
po 6 (pop out to SS)
fp, pf - foul pop out
ex.
fp 2 (foul pop to C)
sf - sacrifice fly
ex.
sf 8 3h (sac fly to CF, runner on 3rd scores)
sh - sacrifice hit
ex.
sh 1-3 2312 (sac bunt, runners on 2nd and 1st advance)
lf - long fly
wt, df - warning track fly (from deep fly chart)
Possible result of Deep Fly (DF)
ex.
lf 7 (long fly to LF)
wt 7 3h23 (warning track fly, runner on 3rd scores,
runner on 2nd to 3rd)
er - batter reaches on error
ex.
er 5 (error on 3B, runners advance 1 base, batter safe at 1st)
ea - runner advances on error
Used primarily in conjuction with a base-hit plus error result
(1b+1) on error chart
ex.
1b lf
ea 7 12 (batter singles to LF and ball is bobbled allowing
batter to advance to 2nd)
generic codes:
fo - fly out
go - ground out
************
UNDO WARNING
************
Undo is the most precarious part of our program, i.e. the most likely
way to crash grs. The current status is:
Undo seems to be 100% functional.
NEVER, EVER, use the -f flag with an undo command imbedded in the
input file! the undo event is never recorded in a .cmd file, and GRS
is not expecting it! there will be grave (although quite comical)
consequences if you ignore this.
The moral of the story is, use undo at your own risk. What is listed
above is the "observed" pattern of activity of undo. It *may* crash,
possibly destroying your game report. If you don't want to try undo,
just end the game, then use copy-paste to re-input your commands
(copy from the .cmd file). Or even easier still, use the -f flag.
Below is an example input file for line ups, making setup for each game MUCH
easier:
command line entry for entry file a.txt for gm1 wk 8:
grs -f a.txt 8-1
The file will look like this (parthetical entries are comments only, don't enter
into the actual file):
(begin file)
LAW (Visiting Team 3-letter abbreviation - make sure this is theFIRST line)
Soriano WAS LF (Visiting Team Lineup)
Ross FLA CF
Gibbons BAL DH
Jenkins MIL RF
Blalock TEX 3b
Casey DET 1b
Navarro TB C
Frandsen SF 2b
Berroa KC SS
COU (Home Team 3-letter abbreviation)
Kinsler TEX 2b (Home Lineup)
Byrnes ARI LF
Giles SD RF
Barrett CHN C
Fielder MIL 1b
Thorman ATL DH
Patterson BAL CF
Cedeno CHN SS
Inge DET 3b
Kim COL R (Visiting Pitcher, Right-handed)
Francis COL L (Home Pitcher, Left-handed)
Cool, Clear, No Wind, Wo Precip (Weather - make sure to follow this line with
a <return>)
(end file)
Here is the Mini-GRS file and GRS file header:
(begin file)
SCORES
LAW 2 1 1
COU 10 4 4
INJURIES [make sure to use this format for injuries)
1 x LAW KC Dejesus 2 (2 served, baby after game)
3 x COU CHN Cedeno 2 (twing after game)
STARTS
1 LF COU ATL Thorman
1 SS COU CHN Cedeno
LIMITS (you can leave this section blank)
1 1b COU ATL Thorman 1 PA vsLH
LAW PITCHING
gm1: PIT Duke 2.1 (L), COL Affeldt 2.2, DET Grilli 1.2, BAL Britton 1.1
gm2: CHA Garland 8.0 (L)
gm3: COL Kim 7.0 (L), COL Affeldt 1.0
COU PITCHING
gm1: CHN Zambrano 6.0 (W), PHI Hamels 2.0, TEX Benoit 1.0
gm2: COL Francis 6.2, ARI Cruz 0.1, PIT Gonzalez 1.0, MIL Cordero 1.0 (S)
gm3: OAK Haren 8.0, MIL Cordero 1.0 (S)
ROTATION (make sure you include the HOME series rotation!!!!!)
HOU Oswalt, PHI Hamels, COL Francis
TRANSACTIONS
Activate: HOU Oswalt
Deactivate: CHA Sweeney
grs_instructions.1228402035.txt.gz · Last modified: 2008/12/04 09:47 by christian_spo