Class GSM8KBenchmark<T>

Namespace

AiDotNet.Reasoning.Benchmarks

Assembly

AiDotNet.dll

Grade School Math 8K (GSM8K) benchmark for evaluating mathematical reasoning.

public class GSM8KBenchmark<T> : IBenchmark<T>

Type Parameters

T

The numeric type used for scoring (e.g., double, float).

Inheritance

object

GSM8KBenchmark<T>

Implements

IBenchmark<T>

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Remarks

For Beginners: GSM8K is a dataset of 8,500 grade school math word problems. These are the kinds of problems you'd see in elementary school math:

Example problems:

• "Janet has 15 apples. She gives 40% to her friend. How many does she have left?"
• "A train travels 60 mph for 2.5 hours. How far does it go?"
• "If 3 pizzas cost $45, how much does 1 pizza cost?"

Why it's important:

• Tests basic mathematical reasoning
• Requires understanding word problems
• Needs step-by-step calculation
• Benchmark for many reasoning models

Performance levels:

• Human performance: ~90-95%
• GPT-3.5: ~57%
• GPT-4: ~92%
• ChatGPT o1: ~95%
• DeepSeek-R1: ~97%

Research: "Training Verifiers to Solve Math Word Problems" (Cobbe et al., 2021) https://arxiv.org/abs/2110.14168

Constructors

GSM8KBenchmark()

Initializes a new instance of the GSM8KBenchmark<T> class.

public GSM8KBenchmark()

Properties

BenchmarkName

Gets the name of this benchmark.

public string BenchmarkName { get; }

Property Value

string

Description

Gets a description of what this benchmark measures.

public string Description { get; }

Property Value

string

TotalProblems

Gets the total number of problems in this benchmark.

public int TotalProblems { get; }

Property Value

int

Methods

EvaluateAsync(Func<string, Task<string>>, int?, CancellationToken)

Evaluates a reasoning strategy on this benchmark.

public Task<BenchmarkResult<T>> EvaluateAsync(Func<string, Task<string>> evaluateFunction, int? sampleSize = null, CancellationToken cancellationToken = default)

Parameters

evaluateFunction Func<string, Task<string>>

Function that takes a problem and returns an answer.

sampleSize int?

Number of problems to evaluate (null for all).

cancellationToken CancellationToken

Cancellation token.

Returns

Task<BenchmarkResult<T>>

Benchmark results with accuracy and detailed metrics.

Remarks

For Beginners: This runs the benchmark by: 1. Selecting problems (either all or a random sample) 2. Asking the reasoning system to solve each one 3. Comparing answers to the correct solutions 4. Calculating accuracy and other metrics

The evaluateFunction is your reasoning system - it takes a problem string and returns an answer string.

LoadProblemsAsync(int?)

Loads benchmark problems (for inspection or custom evaluation).

public Task<List<BenchmarkProblem>> LoadProblemsAsync(int? count = null)

Parameters

count int?

Number of problems to load (null for all).

Returns

Task<List<BenchmarkProblem>>

List of benchmark problems.

Remarks

For Beginners: Returns the actual problems and their correct answers so you can inspect them or run custom evaluations.