Skip to main content
mathipy Logo

PyPI version Python versions License: MIT

Multimodal item feature extraction for K-12 math assessment. Reads item text and images through one entry point, with math-aware normalization via textstat and NLTK. Measure readability, Common Core State Standards for Mathematics domain, cognitive load, and the relations carried by wording or by notation. Classify item images into visual types with an instructional role, read shape subtypes with OpenCV and Pillow, and extract text through Gemini and OpenAI vision APIs.

Installation

pip install mathipy

With optional dependencies:

pip install "mathipy[nlp]"        # readability (textstat, nltk)
pip install "mathipy[vision]"     # visual analysis (opencv, pillow)
pip install "mathipy[ocr]"        # OCR via vision LLMs (httpx)
pip install "mathipy[documents]"  # document parsing (python-docx, pdfplumber)
pip install "mathipy[all]"        # all features

From GitHub:

pip install "mathipy[all] @ git+https://github.com/mshin77/mathipy.git"

Getting Started

See Quick Start and Analyzing Math Items for tutorials.

Citation

  • Shin, M. (2026). mathipy: Multimodal item feature extraction for K-12 math assessment (Python package version 0.4.14) [Computer software]. https://github.com/mshin77/mathipy

Metadata

Release files for mathipy 0.4.14

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mathipy 0.4.14
File Size Uploaded
mathipy-0.4.14.tar.gz 73.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mathipy 0.4.14
File Interpreter ABI Platform
mathipy-0.4.14-py3-none-any.whl Python 3 none any Details

Total release size: 152.7 kB

Release files / mathipy-0.4.14.tar.gz

Download URL mathipy-0.4.14.tar.gz
Size 73.1 kB
Tags Source
SHA-256 checksum
How to use checksums
88d467b67e618d565ba15279fb9fa9b41d950d5c0a23e94974bcc477693ced31
BLAKE2b-256 checksum
How to use checksums
2dcbe6e3f675f7f7e9b6d2c990cdc28762c26f462934880f847bf6ddfb0d8723
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.6

Release files / mathipy-0.4.14-py3-none-any.whl

Download URL mathipy-0.4.14-py3-none-any.whl
Size 79.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
82594dcf89a84852b56249ee9fd15fbac282044c2190ecfddf9212bcccea764a
BLAKE2b-256 checksum
How to use checksums
9507cd0ccee4698f2e94520dc4308bf4cc49be3392d8a130d6c20abb16934e66
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.6

Release history Release notifications | RSS feed

0.4.15

2 release files

This release

0.4.14 This release

2 release files

0.4.12

2 release files

0.4.11

2 release files

0.4.10

2 release files

0.4.9

2 release files

0.4.8

2 release files

0.4.7

2 release files

0.4.6

2 release files

0.4.5

2 release files

0.4.4

2 release files

0.4.3

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.0

2 release files

0.2.0

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page