mathgenerator

A math problem generator, created for the purpose of giving self-studying students and teaching organizations the means to easily get access to random math problems to suit their needs.

To try out generators, go to https://lukew3.github.io/mathgenerator

See CONTRIBUTING.md for information about how to contribute.

Table of Contents

• Installation
• Basic Usage
  • More Complicated Usage
• Documentation
• List of Generators
  • algebra
  • basic_math
  • calculus
  • computer_science
  • geometry
  • misc
  • statistics

Installation

The project can be install via pip

pip install mathgenerator

Basic Usage

Here is an example of how you would generate an addition problem:

from mathgenerator import mathgen

#generate an addition problem
problem, solution = mathgen.addition()

#another way to generate an addition problem using genById()
problem, solution = mathgen.genById(0)

Creating a worksheet

If you wish to create a worksheet, you can use the worksheetgen package. Install this with pip install worksheetgen. Here is an example of how a worksheet would be generated.

from mathgenerator import mathgen
from worksheetgen.wg import Worksheet

ws = Worksheet("Worksheet title")
with ws.section('Section 1', description='These are instructions')
	# Writes 10 problems generated with id 1, [0] at the end specifies to take problem, and not solution.
	for _ in range(10):
		ws.add_problem(mathgen.genById(1)[0])
ws.write_pdf()

This creates the pdf ws.pdf in your current directory

Documentation

• getGenList() returns a list of all generators in the repository in the format [id, title, self, funcname, subjectname]

• genById(id) generates a problem, solution set with generator id id in the format [problem, solution]

• Pass the kwarg format=latex to return problem and solution set as latex. If latex is not available for that generator, the problem will return the string "Latex unavailable"

• Pass the kwarg format=raw to return just the raw data for each generator. An array of each variable necessary to the generator is returned.

List of Generators

algebra

basic_math

calculus

computer_science

geometry

misc

statistics