Skip to content

Releases: davewalker5/CricketTracker

Version 1.3.0.0

Choose a tag to compare

@davewalker5 davewalker5 released this 28 Jul 18:34
495609c

This release introduces the first dedicated Analysis capability in Cricket Tracker.

The new Analysis tab builds on the existing match, result and innings-summary data to provide a small set of reports designed for a fan following and recording a competition for themselves.

The initial release includes:

  • Team Summary
  • Batting First vs Chasing
  • Head-to-Head

The reports support the limited-overs formats currently modelled by Cricket Tracker:

  • The Hundred
  • Twenty20
  • One Day International

Team Summary

The Team Summary report provides an overview of one team’s performance within a selected competition and season.

It includes:

  • Matches played
  • Wins, losses, ties and no-results
  • Win percentage
  • Runs scored and conceded
  • Average innings scores
  • Average wickets lost and taken
  • Highest and lowest innings totals
  • Record when batting first
  • Eecord when chasing
  • Largest and narrowest wins and defeats
  • A chronological match history

Results are shown from the selected team’s perspective, making it easier to review how the team has performed across the competition.

Batting First vs Chasing

The Batting First vs Chasing report adds the first analysis designed specifically around the structure of a cricket match.

It can be used at either competition or team level and includes:

  • Wins by teams batting first
  • Wins by teams chasing
  • Batting-first and chasing win percentages
  • Average first-innings score
  • Highest first-innings score
  • Highest successful chase
  • Lowest successfully defended total
  • Team-specific records when setting or chasing a target
  • A supporting table of analysed matches

Batting order is derived from the recorded innings rather than inferred from the result, home and away status or toss decision.

Head-to-Head

The Head-to-Head report compares two teams within a selected competition and season.

It includes:

  • Matches played
  • Wins by each team
  • Ties and no-results
  • Win percentages
  • Total and average runs scored
  • Average wickets lost
  • Highest and lowest innings
  • Batting-first and chasing records
  • Largest and narrowest wins
  • Highest successful chase
  • Lowest successfully defended total
  • A complete history of meetings

This provides a compact view of both the overall record and the individual matches behind it.

Format-Aware Analysis

The reports use a shared limited-overs analysis model while respecting differences between formats.

Scoring rates are displayed as:

  • Runs per 100 balls for The Hundred
  • Runs per over for T20 and ODI cricket

Rates are calculated from the number of balls faced, avoiding the common mistake of treating cricket over notation as a decimal value.

The reports do not combine unlike formats into a single statistical sample.

Incomplete and No-Result Matches

Analysis is calculated only where the recorded data supports the metric being shown.

For example:

  • A completed result may still contribute to a team’s win-loss record when detailed innings data is unavailable
  • An innings without a recorded ball count may contribute to score analysis but not scoring-rate analysis
  • No-results are recorded separately and excluded from calculations where a decisive outcome is required
  • Matches with ambiguous innings order are excluded from batting-first and chasing comparisons

This allows Cricket Tracker to make useful use of partially complete historical records without presenting unsupported statistics.

Scope

The Analysis tab uses match-level and innings-summary data already stored by Cricket Tracker.

It does not require:

  • Ball-by-ball data
  • Full scorecards
  • Player batting or bowling records
  • Partnerships
  • Boundary analysis
  • Predictive modelling

The intention is to provide a focused set of useful reports rather than turn Cricket Tracker into a general-purpose cricket statistics platform.

Looking Ahead

Possible future additions include:

  • Team Form
  • Venue analysis
  • Toss decision analysis
  • Score distributions
  • All-season Head-to-Head analysis
  • PDF report export
  • Test cricket analysis

These will be considered separately once the initial reports have been used with a broader set of real competition data.

Version 1.2.0.0

Choose a tag to compare

@davewalker5 davewalker5 released this 28 Jul 16:07
aad53ce

This release expands Cricket Tracker beyond The Hundred with first-class support for Twenty20 and One Day cricket.

Competitions can now use distinct match formats and configurable rulesets while retaining compatibility with existing Hundred data.

Highlights

  • Added built-in match formats for The Hundred, T20 and ODI cricket
  • Added format-aware innings limits and cricket-over displays
  • Added automatic result calculation for standard limited-overs matches
  • Added support for revised allocations, externally supplied targets and DLS-labelled results
  • Added ruleset-driven points and net run rate
  • Extended CSV import and export for limited-overs data
  • Added complete T20 and ODI sample datasets

Match Formats and Rulesets

Match format and competition rules are now modelled separately.

A match format defines the structure of a match, including:

  • Default balls per innings
  • Balls per over or scoring unit
  • Wickets available per innings
  • The way delivery progress is displayed

Competition rulesets continue to define competition-specific behaviour, including:

  • Points for wins, ties, losses, abandonments and no results
  • Whether standings and net run rate are enabled
  • Table sorting order
  • Whether tied results may stand
  • Whether tie-break winners are allowed
  • Whether revised targets may be recorded

This allows different competitions to share a format such as T20 while retaining their own points and standings rules.

Match and Innings Recording

Matches can now record:

  • A scheduled delivery allocation
  • A reduced or revised allocation
  • An original target
  • An externally supplied revised target
  • A result method such as DLS
  • A manual result override and its reason

Innings records now include a completion status, such as:

  • Innings limit reached
  • All out
  • Target reached
  • Declared complete
  • Abandoned
  • Incomplete

Input validation prevents negative scores and wickets, excessive wicket counts, and delivery totals beyond the applicable innings allocation.

Legal deliveries continue to be stored as whole ball counts. T20 and ODI progress is displayed using conventional cricket-over notation, while Hundred matches retain their existing ball-based display.

Automatic Results

Cricket Tracker can derive standard match results from completed innings, including:

  • Wins by runs
  • Wins by wickets
  • Ties
  • No results
  • Abandoned matches
  • Matches decided using an externally supplied revised target

The application records a result method such as DLS but does not calculate DLS targets itself.

Manual result overrides remain available for exceptional cases and are clearly identified in the interface.

Standings and Net Run Rate

League standings now use the selected competition ruleset when awarding points.

Net run rate is calculated from completed innings summaries when enabled. All-out innings use the applicable full delivery allocation.

Matches involving revised allocations or revised targets are excluded from net run rate because their competition-specific treatment cannot be derived reliably from innings summaries alone.

Import and Export

Match CSV files now support these optional fields:

  • scheduled_balls
  • revised_balls
  • target_runs
  • revised_target_runs
  • result_method

Innings CSV files now support:

  • innings_status

Existing Hundred CSV files remain compatible. When allocation fields are omitted, Cricket Tracker uses the default defined by the selected match format.

Self-contained T20 and ODI examples are included under data/samples.

User Interface Improvements

  • Competition, match and innings editors are format-aware
  • Match and innings views show the relevant format and delivery allocation
  • Scores use the appropriate balls or overs presentation
  • Filters support the newly added match formats

Compatibility

Existing Cricket Tracker databases are upgraded automatically when the application starts.

Existing Hundred competitions, matches, innings, imports and standings remain supported. Legacy records are associated with The Hundred format during migration where appropriate.

Supported Scope

Cricket Tracker now supports one-innings limited-overs competitions using:

  • The Hundred
  • Twenty20
  • One Day cricket

The application does not currently support:

  • Test or first-class cricket
  • Matches with multiple innings per team
  • Ball-by-ball scoring
  • Automatic DLS calculation
  • Competition-specific tie-break simulations such as Super Overs

Version 1.1.0.0

Choose a tag to compare

@davewalker5 davewalker5 released this 28 Jul 13:20
a3af96b

The first tagged release of Cricket Tracker establishes the application as a local-first tool for recording and exploring cricket competitions, fixtures, results, innings summaries and league standings.

This initial version focuses on The Hundred men's and women's competitions. It deliberately avoids ball-by-ball scoring and complete scorecards, concentrating instead on the information needed to maintain a clear and useful record of a competition and its results.

Highlights

  • Structured management of countries, venues, teams and competitions
  • Separate support for men's and women's teams and competitions
  • Fixture scheduling, round and venue details
  • Toss winner and toss decision recording
  • Structured match results, including wins by runs or wickets
  • Innings summaries containing runs, wickets and balls faced
  • Automatic result calculation from completed innings data
  • Configurable competition points and knockout-stage rules
  • Dynamically calculated league tables
  • Support for wins, losses, ties and no-results
  • Net run rate calculated from innings data
  • Separate CSV import and export for matches and innings

Supported Competitions

The initial release includes support for:

  • The Hundred Men
  • The Hundred Women

Competitions are season-specific and use configurable rules for points allocation and the inclusion or exclusion of knockout matches from league standings.

Match and Innings Recording

Match records contain the fixture-level details, including:

  • Competition and round
  • Date and start time
  • Venue
  • Home and away teams
  • Toss details
  • Match status
  • Winning team
  • Result type
  • Result margin

Innings are stored separately and record:

  • Innings number
  • Batting team
  • Runs scored
  • Wickets lost
  • Balls faced

This separation allows future fixtures to be imported with empty innings records and completed after the match has taken place.

Where sufficient innings data is available, Cricket Tracker can determine the winning team, result type and margin automatically.

League Tables

League standings are calculated dynamically rather than stored in the database.

The table includes:

  • Played
  • Won
  • Lost
  • Tied
  • No Result
  • Points
  • Runs For
  • Balls Faced
  • Runs Against
  • Balls Bowled
  • Net Run Rate

The calculation respects the selected competition's points system and knockout inclusion rules.

Data Import and Export

CSV import and export are available for:

  • Countries
  • Venues
  • Teams
  • Competitions
  • Matches
  • Innings

Matches and innings use separate files so that fixture information can be managed independently from completed innings data.

Calculated league tables can also be exported as CSV or formatted PDF documents.

Scope

This release is intended as a competition and results tracker rather than a comprehensive scoring system.

It does not currently include:

  • Ball-by-ball data
  • Full batting scorecards
  • Bowling figures
  • Partnerships
  • Fall-of-wicket details
  • Player statistics
  • Live scoring feeds
  • Automated collection from external cricket services

The emphasis is on a maintainable, inspectable record of fixtures, results, innings summaries and competition standings.

Looking Ahead

Version 1.1.0.0 provides the cricket-specific foundation on which broader competition support and supporter-focused analysis can be developed.

Additional competitions can be introduced as their formats, points systems and standings rules are modelled.