Skip to main content

SciMatic

A Python library for mathematics, statistics, science, and scientific computing.

SciMatic is a lightweight, student-friendly Python library designed to make mathematical and scientific calculations easier to perform programmatically.

«From basic mathematics to advanced scientific concepts — all in Python(Include rust extension).»


Features

SciMatic is built around modular mathematical tools.

Mathematics

  • Quadratic equations
  • Quadratic inequalities
  • Factorials
  • Mathematical operators
  • PEMDAS/BODMAS expression evaluation
  • Custom mathematical functions

Statistics

  • Mean
  • Median
  • Mode
  • Quartiles
  • Deciles
  • Percentiles
  • Interpolation

Trigonometry

  • Law of Sines
  • Law of Cosines
  • Trigonometric calculations
  • Triangle-related mathematics

Parser

SciMatic includes a general-purpose parser for processing mathematical expressions and tokens.

The parser can split input into:

  • Characters
  • Words
  • Tokens
  • Keyword Arguments

It can also convert recognized tokens into numerical values such as integers and floats.

Scientific Computing

SciMatic is designed to eventually expand beyond pure mathematics into scientific computing, including modules for:

  • Physics
  • Thermodynamics
  • Calculus
  • Engineering mathematics
  • Advanced scientific calculations

Computer Engineering

SciMatic also offers functions that are in the computer engineering field.

  • Logic Gates
  • 7-Segment Display system
  • Half/Full Adders
  • High-Performance signal flickers

Databasing

SciMatic also offers a database to store all the returned values with just a decorator.

  • Storing returned values, no matter the type
  • displaying the values stored
  • deleting certain functions

Conversion

SciMatic has functions that can convert certain measures from time, measurements, etc.

  • Imperial-to-metric conversion(v.v.)(from quetto to quetta)
  • Currency conversion(uses another database for offline mode)
  • temperature conversion(supports °C, °F, k, °R, °Ré)
  • Time conversion

CSV

SciMatic has functions that enable it to modify, duplicate, and read/write .csv files.

  • Serialization/Deserialization of CSV values
  • Read/Write .csv files
  • Special Bracket convention to distinguish SciMatic-Made duplicates from other common convention(example[1].csv)

Installation

Install SciMatic using pip:

pip install scimatic

Then import it in Python:

import scimatic

Quick Start

Basic calculations

import scimatic

print(scimatic.utils.convenient_utils.factorial(5))

Output:

120

Expression Parsing

SciMatic can be used to process mathematical expressions while respecting operator precedence.

For example:

equation = '2 + 3 * 4'

SciMatic evaluates multiplication before addition:

2 + (3 * 4)

Result:

14

SciMatic's expression system supports operators such as:

+
-
*
/
//
%
**

and parentheses.


Quadratics

SciMatic provides tools for solving quadratic equations.

For an equation such as:

x² + 5x + 6 = 0

SciMatic can determine its roots:

x = -2
x = -3

The quadratic module is designed to provide a convenient programmatic interface for algebraic calculations.


Statistics

SciMatic provides common statistical operations.

Example:

data = [10, 20, 20, 30, 40]

You can calculate values such as:

Mean
Median
Mode
Quartiles
Percentiles

SciMatic also supports interpolation-based statistical calculations.


Modular Architecture

SciMatic is designed as a modular library.

A simplified structure looks like:

SciMatic/
├── .github/workflows
|
├── .gitigore
|
├── Cargo.toml
|
├── pyproject.toml
|
├── README.md <- you are here
|
├── RULES.md
|
├── LICENSE
|
├── rs_scimatic
|   ├── Cargo.toml
|   └── src/
|       ├── lib.rs
|       ├── flicker.rs
|       └── conversion.rs
|
└── scimatic/
    |
    ├── _pycache_/
    |
    ├── __init__.py
    |
    ├── utils/
    |    ├── __init__.py
    |    ├── databasing.py
    |    ├── convenient_utils.py
    |    ├── csv.py
    |    └── conversion/
    |        ├── __init__.py
    |        ├── currency.py
    |        ├── data.py
    |        ├── measurements.py
    |        ├── time.py
    |        ├── temperature.py
    |        └── weight.py
    |
    ├── c_engineering/
    |   ├── __init__.py
    |   ├── circuits.py
    |   ├── logic_gates.py
    |   ├── seg_7display.py
    |   └── signals.py
    |
    ├── mathematic/
    |   ├── __init__.py
    |   ├── algebra.py
    |   ├── errors.py
    |   ├── geometry.py
    |   ├── niche.py
    |   └── statistics.py
    │
    └── scientific/
        ├── biology.py
        ├── earth_science.py
        ├── thermodynamics.py
        └── mechanics.py

This allows different areas of mathematics and science to remain separated while still being part of the same library.


Error Handling

SciMatic provides specialized exceptions for mathematical errors.

Examples include:

DataError
NegativeDiscriminantError
VariableError

These errors are intended to make invalid mathematical input easier to identify and handle.


Philosophy

SciMatic is designed around three principles:

Simple

Mathematical operations should be easy to understand and use.

Modular

Different mathematical disciplines should be separated into dedicated modules.

Extensible

SciMatic should be able to grow from a mathematics library into a broader scientific-computing ecosystem.


Development

SciMatic is currently under active development.

The project is intended to expand into areas such as:

  • Advanced calculus
  • Thermodynamics
  • Physics
  • Scientific simulations
  • More advanced statistics
  • Probability
  • Engineering mathematics
  • Scientific computing

Roadmap

Mathematics

  • Basic mathematical utilities
  • Expression parser
  • Operator handling
  • Quadratic calculations
  • Statistical utilities
  • Trigonometric utilities
  • More advanced calculus
  • More advanced algebra

Statistics

  • Mean
  • Median
  • Mode
  • Quartiles
  • Percentiles
  • Interpolation
  • Advanced statistical analysis

Science

  • Physics module
  • Thermodynamics
  • Scientific constants
  • Engineering calculations
  • Advanced scientific simulations

Computer Engineering

  • Logic Gates
  • Binary translation
  • 7-display
  • Circuitry

Future

  • Improved documentation
  • More comprehensive testing
  • Performance optimization
  • Expanded API
  • Educational examples

Contributing

Contributions, suggestions, and bug reports are welcome.

If you find a bug or have an idea for SciMatic, feel free to open an issue or submit a pull request.

When contributing, please try to keep new functionality modular and well documented.


License

SciMatic is distributed under its project license.

See the "LICENSE" file for the full license terms.


Author

SciMatic is an independently developed Python project focused on making mathematics and scientific computing accessible through code.


Support the Project

If you find SciMatic useful, consider giving the project a ⭐ on GitHub.

Every improvement, experiment, and contribution helps SciMatic grow.

SciMatic — Mathematics, engineered for Python.

Metadata

Release files for SciMatic 1.81.0

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

Built distributions (wheels)

Table of built distributions (wheels) for SciMatic 1.81.0
File Interpreter ABI Platform Actions
scimatic-1.81.0-cp39-abi3-win_amd64.whl CPython 3.9 abi3 Windows x86-64 Details for scimatic-1.81.0-cp39-abi3-win_amd64.whl
scimatic-1.81.0-cp39-abi3-manylinux_2_34_x86_64.whl CPython 3.9 abi3 Linux glibc 2.34+ x86-64 Details for scimatic-1.81.0-cp39-abi3-manylinux_2_34_x86_64.whl

Total release size: 502.2 kB

Release files / scimatic-1.81.0-cp39-abi3-win_amd64.whl

Download URL scimatic-1.81.0-cp39-abi3-win_amd64.whl
Size 180.3 kB
Tags CPython 3.9 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
1d73294f654919d203c4cd9fde2294da12b70198eb429f0de00ebba6ba2b54a3
BLAKE2b-256 checksum
How to use checksums
0e77c69728fe799e6f3ae75d912303b3b401167a74b4e83c567222d86a710a45
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.

Transparency log

Release files / scimatic-1.81.0-cp39-abi3-manylinux_2_34_x86_64.whl

Download URL scimatic-1.81.0-cp39-abi3-manylinux_2_34_x86_64.whl
Size 321.9 kB
Tags CPython 3.9 Linux glibc 2.34+ x86-64 abi3
SHA-256 checksum
How to use checksums
8acfdd7edf542a81d906324ed62aa306c89aa32603cb8711ca66373cfd0cdc16
BLAKE2b-256 checksum
How to use checksums
0b9cef4fe9d8aef8b909b97230b55d8503ca837a6759580c0e4563adfb0bf0e3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.

Transparency log

Security for SciMatic 1.81.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for scimatic-1.81.0-cp39-abi3-win_amd64.whl

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.81.0 This release

2 release files Full provenance

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