Documentation for SportsML/American Football

Version: 0.5
Creator: IPTC
PublicId: -//IPTC//SportsML DTD 0.7//EN

Description

SportsML Plug-in for American Football

Root elements

Element index

action-american-football-drive A series of plays that may result in a score.
action-american-football-other A custom action.
action-american-football-penalty Describes a penalty. Like plays, contains participant elements.
action-american-football-play Only for non-scoring plays.
action-american-football-play-participant Describes which player was involved in the play and how.
action-american-football-score A play that ended in a score.
action-american-football-substitution A substitution.
action-american-football-timeout Describes a timeout.
all-specific-elements A placeholder, to help isolate sport-specific elements.
event-actions-american-football Description of an event.
event-metadata-american-football Metadata about the event itself.
player-metadata-american-football Player metadata that is specific to football.
player-stats-american-football Player statistics for football.
stats-american-football-defensive Statistics about a particular player or team's defensive performance.
stats-american-football-down-progress Statistics about a particular team or player's performance on downs.
stats-american-football-fumbles For tracking fumble stats.
stats-american-football-offensive Statistics about a particular team or player's offensive performance.
stats-american-football-passing Statistics about a particular team or player's passing performance.
stats-american-football-penalties Statistics about penalties.
stats-american-football-rushing Statistics about a particular team or player's rushing performance.
stats-american-football-sacks-against Statistics about the sacks suffered by the offensive team.
stats-american-football-scoring Statistics about a particular team's scoring performance.
stats-american-football-special-teams Statistics about a particular team's special teams performance.
team-metadata-american-football Metadata about a particular team.
team-stats-american-football Statistics about a particular team.

Element descriptions

action-american-football-drive

A series of plays that may result in a score. Ends either in a score, or in a change of possession.

Attributes

Name Description
Type (Declaration) Default
clock-state Whether the clock is running or stopped.
['stopped', 'running'] (#IMPLIED )
comment A comment.
CDATA (#IMPLIED )
distance-for-1st-down The distance between the current line of scrimmage and the first down marker. In yards. The word goal is used for, say, 3rd-and-goal situations. The word kick is used for an extra-point attempt.
CDATA (#IMPLIED )
down The current down. Valid values are 1,2,3,4,5, with 5th down used for Canadian Football.
['1', '2', '3', '4', '5'] (#IMPLIED )
drive-duration The time it took for the drive.
CDATA (#IMPLIED )
drive-plays The number of plays in this drive.
CDATA (#IMPLIED )
drive-result (Controlled vocabulary.)
CDATA (#IMPLIED )
drive-yards The number of yards covered during this drive.
CDATA (#IMPLIED )
field-line The line of scrimmage. Where the ball is at the start of play or play-segment.
CDATA (#IMPLIED )
field-side Which side of the field the event is taking place. Either "home" or "visiting".
['home', 'away'] (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
period-time-elapsed The time elapsed since the beginning of the period.
CDATA (#IMPLIED )
period-time-remaining The time remaining in the period.
CDATA (#IMPLIED )
period-value An interger. 1,2,3,4 for the main quarters. 5,6,7,etc. for overtime periods.
CDATA (#IMPLIED )
team-in-possession-idref The ID of the team with the football.
CDATA (#IMPLIED )

Parents

event-actions-american-football

Content model

((action-american-football-play | action-american-football-substitution | action-american-football-penalty | action-american-football-timeout)* , action-american-football-score?)

action-american-football-other

A custom action. For use when none of the pre-build actions apply.

Attributes

Name Description
Type (Declaration) Default
action-source The name of the controlled-vocabulary for the action-type attribute.
CDATA (#IMPLIED )
action-type A selection from a controlled-vocabulary list maintained by the publisher.
CDATA (#IMPLIED )
clock-state Whether the clock is running or stopped.
['stopped', 'running'] (#IMPLIED )
comment Textual comment about the action.
CDATA (#IMPLIED )
distance-for-1st-down The distance between the current line of scrimmage and the first down marker. In yards. The word goal is used for, say, 3rd-and-goal situations. The word kick is used for an extra-point attempt.
CDATA (#IMPLIED )
down The current down. Valid values are 1,2,3,4,5, with 5th down used for Canadian Football.
['1', '2', '3', '4', '5'] (#IMPLIED )
field-line The line of scrimmage. Where the ball is at the start of play or play-segment.
CDATA (#IMPLIED )
field-side Which side of the field the event is taking place. Either "home" or "visiting".
['home', 'away'] (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
period-time-elapsed The time elapsed since the beginning of the period.
CDATA (#IMPLIED )
period-time-remaining The time remaining in the period.
CDATA (#IMPLIED )
period-value An integer. 1,2,3,4 for the main quarters. 5,6,7,etc. for overtime periods.
CDATA (#IMPLIED )
team-in-possession-idref The ID of the team with the football.
CDATA (#IMPLIED )

Parents

event-actions-american-football

Content model

EMPTY

action-american-football-penalty

Describes a penalty. Like plays, contains participant elements. These penalties occur before a play is officially started.

Attributes

Name Description
Type (Declaration) Default
caller-idref A pointer to the official who called the penalty.
IDREF (#IMPLIED )
clock-state Whether the clock is running or stopped.
['stopped', 'running'] (#IMPLIED )
comment A textual comment.
CDATA (#IMPLIED )
distance-for-1st-down The distance between the current line of scrimmage and the first down marker. In yards. The word goal is used for, say, 3rd-and-goal situations. The word kick is used for an extra-point attempt.
CDATA (#IMPLIED )
down The current down. Valid values are 1,2,3,4,5, with 5th down used for Canadian Football.
['1', '2', '3', '4', '5'] (#IMPLIED )
field-line The line of scrimmage. Where the ball is at the start of play or play-segment.
CDATA (#IMPLIED )
field-side Which side of the field the event is taking place. Either "home" or "visiting".
['home', 'away'] (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
penalty-acceptance Whether the penalty was accepted or declined.
['accepted', 'declined'] (#IMPLIED )
penalty-level The level of the penalty. (Controlled vocabulary.)
CDATA (#IMPLIED )
penalty-side Whether a penalty is assessed on the offense or the defense. (Controlled vocabulary.)
CDATA (#IMPLIED )
period-time-elapsed The time elapsed since the beginning of the period.
CDATA (#IMPLIED )
period-time-remaining The time remaining in the period.
CDATA (#IMPLIED )
period-value An interger. 1,2,3,4 for the main quarters. 5,6,7,etc. for overtime periods.
CDATA (#IMPLIED )
recipient-idref A pointer to the receiver of the penalty.
IDREF (#IMPLIED )
recipient-type Whether the receiver of the penalty was the team, the player, a coach, a ref, etc.
['team', 'player', 'auxilliary', 'official'] (#REQUIRED )
team-in-possession-idref The ID of the team with the football.
CDATA (#IMPLIED )

Parents

action-american-football-drive

Content model

(action-american-football-play-participant*)

action-american-football-play

Only for non-scoring plays. Holds elements that describe the role each play participant performed.

Attributes

Name Description
Type (Declaration) Default
clock-state Whether the clock is running or stopped.
['stopped', 'running'] (#IMPLIED )
comment A textual comment.
CDATA (#IMPLIED )
distance-for-1st-down The distance between the current line of scrimmage and the first down marker. In yards. The word goal is used for, say, 3rd-and-goal situations. The word kick is used for an extra-point attempt.
CDATA (#IMPLIED )
down The current down. Valid values are 1,2,3,4,5, with 5th down used for Canadian Football.
['1', '2', '3', '4', '5'] (#IMPLIED )
drive-result Describes how a drive ended, if this play ended a drive. (Controlled vocabulary.)
CDATA (#IMPLIED )
field-line The line of scrimmage. Where the ball is at the start of play or play-segment.
CDATA (#IMPLIED )
field-side Which side of the field the event is taking place. Either "home" or "visiting".
['home', 'away'] (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
period-time-elapsed The time elapsed since the beginning of the period.
CDATA (#IMPLIED )
period-time-remaining The time remaining in the period.
CDATA (#IMPLIED )
period-value An interger. 1,2,3,4 for the main quarters. 5,6,7,etc. for overtime periods.
CDATA (#IMPLIED )
score-attempt-type Type of score that was attempted, but missed. (Controlled vocabulary.)
CDATA (#IMPLIED )
score-team After this action took place, the score of the team that team-idref points to.
CDATA (#IMPLIED )
score-team-opposing After this action took place, the score of the team opposing that listed in team-idref.
CDATA (#IMPLIED )
team-in-possession-idref The ID of the team with the football.
CDATA (#IMPLIED )

Parents

action-american-football-drive event-actions-american-football

Content model

(action-american-football-play-participant*)

action-american-football-play-participant

Describes which player was involved in the play and how. The role and result attributes are critical.

Attributes

Name Description
Type (Declaration) Default
clock-state Whether the clock is running or stopped.
['stopped', 'running'] (#IMPLIED )
comment A comment.
CDATA (#IMPLIED )
distance-for-1st-down The distance between the current line of scrimmage and the first down marker. In yards. The word goal is used for, say, 3rd-and-goal situations. The word kick is used for an extra-point attempt.
CDATA (#IMPLIED )
down The current down. Valid values are 1,2,3,4,5, with 5th down used for Canadian Football.
['1', '2', '3', '4', '5'] (#IMPLIED )
field-line The line of scrimmage. Where the ball is at the start of play or play-segment.
CDATA (#IMPLIED )
field-side Which side of the field the event is taking place. Either "home" or "visiting".
['home', 'away'] (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
kick-type If result was kick, then the type of kick. (Controlled vocabulary.)
CDATA (#IMPLIED )
official-idref Which official called the penalty.
CDATA (#IMPLIED )
penalty-acceptance Whether the penalty was accepted or declined.
['accepted', 'declined'] (#IMPLIED )
penalty-type What penalty was called on this player. Called while a play is in progress. (Controlled vocabulary.)
CDATA (#IMPLIED )
period-time-elapsed The time elapsed since the beginning of the period.
CDATA (#IMPLIED )
period-time-remaining The time remaining in the period.
CDATA (#IMPLIED )
period-value An interger. 1,2,3,4 for the main quarters. 5,6,7,etc. for overtime periods.
CDATA (#IMPLIED )
player-idref A pointer to the player involved in the play.
CDATA (#IMPLIED )
result How this segment of the play finished. (Controlled vocabulary.)
CDATA (#IMPLIED )
role Describes how the player got the ball, not what the player did with it. (Controlled vocabulary.)
CDATA (#IMPLIED )
team-in-possession-idref The ID of the team with the football.
CDATA (#IMPLIED )

Parents

action-american-football-penalty action-american-football-play action-american-football-score

Content model

EMPTY

action-american-football-score

A play that ended in a score. Holds participant elements, which detail the role each player had in the scoring play.

Attributes

Name Description
Type (Declaration) Default
clock-state Whether the clock is running or stopped.
['stopped', 'running'] (#IMPLIED )
comment A textual comment.
CDATA (#IMPLIED )
distance-for-1st-down The distance between the current line of scrimmage and the first down marker. In yards. The word goal is used for, say, 3rd-and-goal situations. The word kick is used for an extra-point attempt. Not generally applicable for score actions, but maintained here for consistency.
CDATA (#IMPLIED )
down The current down. Valid values are 1,2,3,4,5, with 5th down used for Canadian Football.
['1', '2', '3', '4', '5'] (#IMPLIED )
field-line The line of scrimmage. Where the ball is at the start of play or play-segment.
CDATA (#IMPLIED )
field-side Which side of the field the event is taking place. Either "home" or "visiting".
['home', 'away'] (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
period-time-elapsed The time elapsed since the beginning of the period.
CDATA (#IMPLIED )
period-time-remaining The time remaining in the period.
CDATA (#IMPLIED )
period-value An interger. 1,2,3,4 for the main quarters. 5,6,7,etc. for overtime periods.
CDATA (#IMPLIED )
points The number of points scored.
CDATA (#IMPLIED )
score-team After this action took place, the score of the team that team-idref points to.
CDATA (#IMPLIED )
score-team-opposing After this action took place, the score of the team opposing that listed in team-idref.
CDATA (#IMPLIED )
score-type (Controlled vocabulary.)
CDATA (#IMPLIED )
team-idref Pointer to the team that scored.
CDATA (#IMPLIED )
team-in-possession-idref The ID of the team with the football.
CDATA (#IMPLIED )

Parents

action-american-football-drive event-actions-american-football

Content model

(action-american-football-play-participant*)

action-american-football-substitution

A substitution. Oftentimes recorded for a quarterback change.

Attributes

Name Description
Type (Declaration) Default
clock-state Whether the clock is running or stopped.
['stopped', 'running'] (#IMPLIED )
comment A comment.
CDATA (#IMPLIED )
distance-for-1st-down The distance between the current line of scrimmage and the first down marker. In yards. The word goal is used for, say, 3rd-and-goal situations. The word kick is used for an extra-point attempt.
CDATA (#IMPLIED )
down The current down. Valid values are 1,2,3,4,5, with 5th down used for Canadian Football.
['1', '2', '3', '4', '5'] (#IMPLIED )
field-line The line of scrimmage. Where the ball is at the start of play or play-segment.
CDATA (#IMPLIED )
field-side Which side of the field the event is taking place. Either "home" or "visiting".
['home', 'away'] (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
period-time-elapsed The time elapsed since the beginning of the period.
CDATA (#IMPLIED )
period-time-remaining The time remaining in the period.
CDATA (#IMPLIED )
period-value An interger. 1,2,3,4 for the main quarters. 5,6,7,etc. for overtime periods.
CDATA (#IMPLIED )
player-original-idref The ID of the player going out.
IDREF (#IMPLIED )
player-original-position The position of the player going out. (Controlled vocabulary.)
CDATA (#IMPLIED )
player-replacing-idref The ID of the player coming in.
IDREF (#IMPLIED )
player-replacing-position The position of the player coming in. (Controlled vocabulary.)
CDATA (#IMPLIED )
substitution-reason The reason for the substitution.
CDATA (#IMPLIED )
team-in-possession-idref The ID of the team with the football.
CDATA (#IMPLIED )

Parents

action-american-football-drive

Content model

EMPTY

action-american-football-timeout

Describes a timeout. A break in the action, usually called by one of the teams playing.

Attributes

Name Description
Type (Declaration) Default
caller Who called the timeout, either team or official. (Controlled vocabulary.)
CDATA (#IMPLIED )
caller-idref If caller is team, say, a pointer to the team element, or a pointer to a player on the team.
IDREF (#IMPLIED )
clock-state Whether the clock is running or stopped.
['stopped', 'running'] (#IMPLIED )
comment A textual comment.
CDATA (#IMPLIED )
distance-for-1st-down The distance between the current line of scrimmage and the first down marker. In yards. The word goal is used for, say, 3rd-and-goal situations. The word kick is used for an extra-point attempt.
CDATA (#IMPLIED )
down The current down. Valid values are 1,2,3,4,5, with 5th down used for Canadian Football.
['1', '2', '3', '4', '5'] (#IMPLIED )
field-line The line of scrimmage. Where the ball is at the start of play or play-segment.
CDATA (#IMPLIED )
field-side Which side of the field the event is taking place. Either "home" or "visiting".
['home', 'away'] (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
period-time-elapsed The time elapsed since the beginning of the period.
CDATA (#IMPLIED )
period-time-remaining The time remaining in the period.
CDATA (#IMPLIED )
period-value An interger. 1,2,3,4 for the main quarters. 5,6,7,etc. for overtime periods.
CDATA (#IMPLIED )
team-in-possession-idref The ID of the team with the football.
CDATA (#IMPLIED )
timeout-type (Controlled vocabulary.)
CDATA (#IMPLIED )

Parents

action-american-football-drive

Content model

EMPTY

all-specific-elements

A placeholder, to help isolate sport-specific elements. Just helps the documentation. Not part of SportsML.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )

Parents

Must appear as the root element.

Content model

(event-metadata-american-football , event-actions-american-football , team-metadata-american-football , team-stats-american-football , player-metadata-american-football , player-stats-american-football)

event-actions-american-football

Description of an event. A play or score should only exist outside a drive for punt-returns or kickoff-returns.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )

Parents

all-specific-elements

Content model

(action-american-football-drive | action-american-football-play | action-american-football-score | action-american-football-other)*

event-metadata-american-football

Metadata about the event itself. Includes the time left, and where the ball is.

Attributes

Name Description
Type (Declaration) Default
clock-state Whether the clock is running or stopped.
['stopped', 'running'] (#IMPLIED )
distance-for-1st-down The distance between the current line of scrimmage and the first down marker. In yards. The word goal is used for, say, 3rd-and-goal situations. The word kick is used for an extra-point attempt.
CDATA (#IMPLIED )
down The current down. Valid values are 1,2,3,4,5, with 5th down used for Canadian Football.
['1', '2', '3', '4', '5'] (#IMPLIED )
field-line The line of scrimmage. Where the ball is at the start of play or play-segment.
CDATA (#IMPLIED )
field-side Which side of the field the event is taking place. Either "home" or "visiting".
['home', 'away'] (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
period-time-elapsed The time elapsed since the beginning of the period.
CDATA (#IMPLIED )
period-time-remaining The time remaining in the period.
CDATA (#IMPLIED )
period-value An interger. 1,2,3,4 for the main quarters. 5,6,7,etc. for overtime periods.
CDATA (#IMPLIED )
team-in-possession-idref The ID of the team with the football.
CDATA (#IMPLIED )

Parents

all-specific-elements

Content model

EMPTY

player-metadata-american-football

Player metadata that is specific to football. Reserved for future use.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )

Parents

all-specific-elements

Content model

EMPTY

player-stats-american-football

Player statistics for football. Includes the same elements as team statistics.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )

Parents

all-specific-elements

Content model

(stats-american-football-offensive? , stats-american-football-defensive? , stats-american-football-scoring? , stats-american-football-special-teams? , stats-american-football-fumbles? , stats-american-football-penalties?)

stats-american-football-defensive

Statistics about a particular player or team's defensive performance. Covers tackles, interceptions, sacks.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )
interceptions-average The average number of yards gained from interceptions.
CDATA (#IMPLIED )
interceptions-longest The longest interception returned. Greatest number of yards gained on an interception.
CDATA (#IMPLIED )
interceptions-total The number of passes the defense has intercepted.
CDATA (#IMPLIED )
interceptions-touchdown Numer of interceptions that were run back for a touchdown.
CDATA (#IMPLIED )
interceptions-yards The number of yards gained as a result of an interception.
CDATA (#IMPLIED )
passes-defensed Total number of times a pass was deflected or otherwise defended against.
CDATA (#IMPLIED )
quarterback-hurries An unofficial stat given when a defensive player pressures and hurries the quarterback into making a throw to avoid being sacked.
CDATA (#IMPLIED )
sacks-total The number of sacks made by the defense.
CDATA (#IMPLIED )
sacks-yards Number of yards gained by the defense.
CDATA (#IMPLIED )
tackles-assists The number of tackles made where multiple members of the defense commited the tackle.
CDATA (#IMPLIED )
tackles-solo The number of tackles made where only one member of the defense commited the tackle.
CDATA (#IMPLIED )
tackles-total The number of tackles made by the defense.
CDATA (#IMPLIED )

Parents

player-stats-american-football team-stats-american-football

Content model

EMPTY

stats-american-football-down-progress

Statistics about a particular team or player's performance on downs. Covers first downs and conversions.

Attributes

Name Description
Type (Declaration) Default
conversions-fourth-down The number of first downs achieved on a fourth down.
CDATA (#IMPLIED )
conversions-fourth-down-attempts The number of fourth downs.
CDATA (#IMPLIED )
conversions-fourth-down-percentage The percentage of first down attempts on a fourth down that were successful.
CDATA (#IMPLIED )
conversions-third-down The number of first downs achieved on a third down.
CDATA (#IMPLIED )
conversions-third-down-attempts The number of third downs.
CDATA (#IMPLIED )
conversions-third-down-percentage The percentage of first down attempts on a third down that were successful.
CDATA (#IMPLIED )
first-downs-pass The number of first downs achieved from passing.
CDATA (#IMPLIED )
first-downs-penalty The number of first downs achieved from penalties on the other team.
CDATA (#IMPLIED )
first-downs-run The number of first downs achieved from rushing.
CDATA (#IMPLIED )
first-downs-total The number of first downs achieved.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )

Parents

stats-american-football-offensive

Content model

EMPTY

stats-american-football-fumbles

For tracking fumble stats. Covers teams that do the fumbling and the recovering.

Attributes

Name Description
Type (Declaration) Default
fumbles-committed The total number of fumbles.
CDATA (#IMPLIED )
fumbles-forced The number of fumbles that were forced by the opposing team.
CDATA (#IMPLIED )
fumbles-lost The number of fumbles that were not recovered by the fumbling team.
CDATA (#IMPLIED )
fumbles-opposing-committed The number of fumbles committed by the opposing team.
CDATA (#IMPLIED )
fumbles-opposing-lost The number of fumbles committed by the opposing team that were subsequently lost to the opposing team.
CDATA (#IMPLIED )
fumbles-opposing-recovered The number of fumbles committed by the opposing but recovered by this team. A subset of turnovers. Also referred to a takeaway.
CDATA (#IMPLIED )
fumbles-opposing-yards-gained The number of yards gained as a result of fumbles by the opposing team.
CDATA (#IMPLIED )
fumbles-own-committed The number of fumbles committed by this team.
CDATA (#IMPLIED )
fumbles-own-lost The number of fumbles committed by this team but recovered by the other team. A subset of turnovers. Also referred to as a giveaway.
CDATA (#IMPLIED )
fumbles-own-recovered The number of fumbles committed by this team that were then also recovered by this team.
CDATA (#IMPLIED )
fumbles-own-yards-gained The number of yards gained as a result of fumbles by this team.
CDATA (#IMPLIED )
fumbles-recovered The number of fumbles that were recovered by the fumbling team.
CDATA (#IMPLIED )
fumbles-yards-gained The number of yards gained as a result of fumbles.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )

Parents

player-stats-american-football team-stats-american-football

Content model

EMPTY

stats-american-football-offensive

Statistics about a particular team or player's offensive performance. Further breaks down stats into passing, rushing, etc.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )
offensive-plays-average-yards-per The average number of yards gained per play.
CDATA (#IMPLIED )
offensive-plays-number The number of offensive plays.
CDATA (#IMPLIED )
offensive-plays-yards The total yards accumulated through offensive plays.
CDATA (#IMPLIED )
possession-duration The average amount of time the team had possession per-drive.
CDATA (#IMPLIED )
turnovers-giveaway Derived by adding passes-interceptions plus fumbles-own-lost.
CDATA (#IMPLIED )

Parents

player-stats-american-football team-stats-american-football

Content model

(stats-american-football-passing? , stats-american-football-rushing? , stats-american-football-down-progress? , stats-american-football-sacks-against?)

stats-american-football-passing

Statistics about a particular team or player's passing performance. Used for quarterbacks and receivers.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )
passer-rating A complex formula designed to measure quarterback performance.
CDATA (#IMPLIED )
passes-attempts The number of passes attempted.
CDATA (#IMPLIED )
passes-average-yards-per The average number of yards gained on completed passes.
CDATA (#IMPLIED )
passes-completions The number of passes completed successfully.
CDATA (#IMPLIED )
passes-interceptions The number of passes that were intercepted.
CDATA (#IMPLIED )
passes-interceptions-percentage The ratio of intercepted passes to attempted passes.
CDATA (#IMPLIED )
passes-longest The yards gained by the single longest completion.
CDATA (#IMPLIED )
passes-percentage The percentage of all passes that are completed successfully.
CDATA (#IMPLIED )
passes-touchdowns The number of passes that resulted in touchdowns.
CDATA (#IMPLIED )
passes-touchdowns-percentage The ratio of touchdown passes to attempted passes.
CDATA (#IMPLIED )
passes-yards-gross The number of yards gained from passing.
CDATA (#IMPLIED )
passes-yards-lost Amount of yards lost due to sacks and completed passing plays that ended behind the line of scrimmage.
CDATA (#IMPLIED )
passes-yards-net Subtracts out the sacks-against-yards-lost value of stats-american-football-sacks-against element.
CDATA (#IMPLIED )
receptions-average-yards-per The average yards per reception.
CDATA (#IMPLIED )
receptions-first-down Number of receptions a player has taken for a first-down.
CDATA (#IMPLIED )
receptions-longest The longest reception a player had, including to the point where they scored, were-tackled, etc.
CDATA (#IMPLIED )
receptions-total The total number of successful passes.
CDATA (#IMPLIED )
receptions-touchdowns Number of receptions a player has caught in or taken to the end-zone.
CDATA (#IMPLIED )
receptions-yards Number of yards a receiver is credited for.
CDATA (#IMPLIED )

Parents

stats-american-football-offensive

Content model

EMPTY

stats-american-football-penalties

Statistics about penalties. Applies to both offensive and defensive penalties.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )
penalties-total The number of penalties.
CDATA (#IMPLIED )
penalty-first-downs The number of first downs gained as a result of penalties.
CDATA (#IMPLIED )
penalty-yards The yards gained as a result of penalties.
CDATA (#IMPLIED )

Parents

player-stats-american-football team-stats-american-football

Content model

EMPTY

stats-american-football-rushing

Statistics about a particular team or player's rushing performance. How well they ran with the ball.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )
rushes-attempts The number of attempted rushes.
CDATA (#IMPLIED )
rushes-first-down The number of rushes that have resulted in a first-down.
CDATA (#IMPLIED )
rushes-longest The number of yards gained by the single longest rushing play.
CDATA (#IMPLIED )
rushes-touchdowns The number of touchdowns resulting from rushing plays.
CDATA (#IMPLIED )
rushes-yards The number of yards gained by rushing.
CDATA (#IMPLIED )
rushing-average-yards-per The average number of yards per rush.
CDATA (#IMPLIED )

Parents

stats-american-football-offensive

Content model

EMPTY

stats-american-football-sacks-against

Statistics about the sacks suffered by the offensive team. How many times and the team was sacked, and for how many yards.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )
sacks-against-total Total number of times that the offense was sacked.
CDATA (#IMPLIED )
sacks-against-yards Total number of yards lost by the offense.
CDATA (#IMPLIED )

Parents

stats-american-football-offensive

Content model

EMPTY

stats-american-football-scoring

Statistics about a particular team's scoring performance. For touchdowns, field goals, etc.

Attributes

Name Description
Type (Declaration) Default
extra-points-attempts The number of extra points attempted by the offense.
CDATA (#IMPLIED )
extra-points-blocked The number of extra points blocked. Extra points made + blocked does not equal attempts.
CDATA (#IMPLIED )
extra-points-made The number of extra points made.
CDATA (#IMPLIED )
extra-points-missed The number of extra points missed.
CDATA (#IMPLIED )
field-goal-attempts The number of field goals attempted.
CDATA (#IMPLIED )
field-goals-blocked The number of field goald blocked. Note that field-goals-made + field-goals-blocked does not equal field-goals-attempts.
CDATA (#IMPLIED )
field-goals-made The number of field goals made.
CDATA (#IMPLIED )
field-goals-missed The number of field goals missed.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
safeties-against The number of safeties scored against the offense.
CDATA (#IMPLIED )
touchbacks-total For Canadian Football. Used to record the number of touchbacks that resulted in scores.
CDATA (#IMPLIED )
touchdowns-defensive The number of touchdowns scored by the defense.
CDATA (#IMPLIED )
touchdowns-passing The number of touchdowns scored by passing.
CDATA (#IMPLIED )
touchdowns-rushing The number of touchdowns scored by rushing.
CDATA (#IMPLIED )
touchdowns-special-teams The number of touchdowns scored by special teams.
CDATA (#IMPLIED )
touchdowns-total The number of touchdowns scored by the offense.
CDATA (#IMPLIED )
two-point-conversions-attempts The number of two point conversions attempted.
CDATA (#IMPLIED )
two-point-conversions-made The number of successful two point conversions.
CDATA (#IMPLIED )

Parents

player-stats-american-football team-stats-american-football

Content model

EMPTY

stats-american-football-special-teams

Statistics about a particular team's special teams performance. Covers punts, touchbacks.

Attributes

Name Description
Type (Declaration) Default
fair-catches The number of fair catches.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
punts-average The average gross punting yardage.
CDATA (#IMPLIED )
punts-blocked The number of punts that were blocked.
CDATA (#IMPLIED )
punts-inside-20 The number of punts inside the 20 yard line.
CDATA (#IMPLIED )
punts-inside-20-percentage The percentage of punts inside the 20 yard line.
CDATA (#IMPLIED )
punts-longest The distance of the longest punt.
CDATA (#IMPLIED )
punts-total The number of punts.
CDATA (#IMPLIED )
punts-yards-gross The sum of the distances of all punts.
CDATA (#IMPLIED )
punts-yards-net The sum of the distances of all punts, minus the distances they were returned.
CDATA (#IMPLIED )
returns-kickoff-average The average number of yards gained on each kickoff return.
CDATA (#IMPLIED )
returns-kickoff-longest The number of yards gained on the longest kickoff return.
CDATA (#IMPLIED )
returns-kickoff-total The number of kickoffs returned.
CDATA (#IMPLIED )
returns-kickoff-touchdown The number of kickoffs returned for a touchdown.
CDATA (#IMPLIED )
returns-kickoff-yards The number of yards gained from kickoff returns.
CDATA (#IMPLIED )
returns-punt-average The average number of yards gained on each punt return.
CDATA (#IMPLIED )
returns-punt-longest The number of yards gained on the longest punt return.
CDATA (#IMPLIED )
returns-punt-total The number of punts returned.
CDATA (#IMPLIED )
returns-punt-touchdown The number of punts returned for a touchdown.
CDATA (#IMPLIED )
returns-punt-yards The number of yards gained from punt returns.
CDATA (#IMPLIED )
returns-total The total number of returns. Punts + kickoffs.
CDATA (#IMPLIED )
returns-yards The total number of yards gained on punts and kickoffs combined.
CDATA (#IMPLIED )
touchbacks-interceptions The number of interceptions that went into the end zone and were not brought out.
CDATA (#IMPLIED )
touchbacks-interceptions-percentage The percentage of interceptions resulting in touchbacks.
CDATA (#IMPLIED )
touchbacks-kickoffs The number of kickoffs that went into the end zone and were not brought out.
CDATA (#IMPLIED )
touchbacks-kickoffs-percentage The percentage of kickoffs resulting in touchbacks.
CDATA (#IMPLIED )
touchbacks-punts The number of punts that went into the end zone and were not brought out.
CDATA (#IMPLIED )
touchbacks-punts-percentage The percentage of punts resulting in touchbacks.
CDATA (#IMPLIED )
touchbacks-total The total number of touchbacks, from kickoffs, punts, interceptions, and fumbles.
CDATA (#IMPLIED )
touchbacks-total-percentage The percentage of kickoffs, punts, interceptions, and fumbles which resulted in a touchback.
CDATA (#IMPLIED )

Parents

player-stats-american-football team-stats-american-football

Content model

EMPTY

team-metadata-american-football

Metadata about a particular team. Reserved for future football-specific attributes.

Attributes

Name Description
Type (Declaration) Default
id An XML-specific identifier for the element.
ID (#IMPLIED )

Parents

all-specific-elements

Content model

EMPTY

team-stats-american-football

Statistics about a particular team. Holds elements that divide statistics into categories.

Attributes

Name Description
Type (Declaration) Default
average-starting-position Average yard-line that the team started on per-drive.
CDATA (#IMPLIED )
id An XML-specific identifier for the element.
ID (#IMPLIED )
time-of-possession The time during the entire event that a team has possession of the ball.
CDATA (#IMPLIED )
timeouts The number of timeouts a team has remaining, either in regulation or in overtime, whichever state the game is currently in.
CDATA (#IMPLIED )
turnover-ratio Derived by subtracting turnovers-giveaways from turnovers-takeaways.
CDATA (#IMPLIED )
yards-per-attempt The average yards gained per play.
CDATA (#IMPLIED )

Parents

all-specific-elements

Content model

(stats-american-football-offensive? , stats-american-football-defensive? , stats-american-football-scoring? , stats-american-football-special-teams? , stats-american-football-fumbles? , stats-american-football-penalties?)
Produced by dtddoc.py, using xmlproc.