mathematicator-core/engine

Math computational Engine

v3.0.1 2021-02-22 18:51 UTC

Requires

• php: ^8.0
• baraja-core/service-method-invoker: ^2.0
• baraja-core/url: ^1.1
• contributte/psr11-container-interface: ^0.4.1
• mathematicator-core/numbers: ^2.1
• mathematicator-core/tokenizer: ^2.1 || ^3.0
• nette/di: ^3.0
• nette/utils: ^3.0
• symfony/translation: ^5.0
• symfony/yaml: ^5.0

Requires (Dev)

• brainmaestro/composer-git-hooks: ^2.8
• jetbrains/phpstorm-attributes: ^1.0
• nette/bootstrap: ^3.0.1
• nette/tester: ^2.3
• phpstan/phpstan: ^0.12.74
• phpstan/phpstan-nette: ^0.12.14
• roave/security-advisories: dev-master
• spaze/phpstan-disallowed-calls: ^1.1
• tracy/tracy: ^2.8

Suggests

• nette/di: (^3.0) To use package in Nette Framework
• tracy/tracy: (^3.0) For advance debugging

MIT

• Jan Barášek

• php
• math
• mathematicator

README

This is a Mathematicator Framework common library for advance work with math patterns, tokens and computing. The library is considered as a sublayer for other tools in Mathematicator Framework.

Installation

composer require mathematicator-core/engine

Features

This package contains set of tools that other mathematicator-core packages have in common.

• Basic controllers
• System / common entities (DAOs)
• Translator (helper and common translations)
• Common exceptions
• Common router

Mathematicator Framework tools structure

The biggest advantage is that you can choose which layer best fits your needs and start build on the top of it, immediately, without the need to create everything by yourself. Our tools are tested for bugs and tuned for performance, so you can save a significant amount of your time, money, and effort.

Framework tend to be modular as much as possible, so you should be able to create an extension on each layer and its sublayers.

Mathematicator framework layers ordered from the most concrete one to the most abstract one:

Search	Modular search engine layer that calls its sublayers and creates user interface.
Vizualizator	Elegant graphic visualizer that can render to SVG, PNG, JPG and Base64. Extensions: Mandelbrot set generator
Calculator	Modular advance calculations layer. Extensions: Integral Solver , Statistics
Engine	Core logic layer that maintains basic controllers, DAOs, translator, common exceptions, routing etc.
Tokenizer	Tokenizer that can convert string (user input / LaTeX) to numbers and operators.
Numbers	Fast & secure storage for numbers with arbitrary precision. It supports Human string and LaTeX output and basic conversions.

Third-party packages:

⚠️ Not guaranteed!

REST API

Install the whole pack as a REST API service on your server (Docker ready) or access it via public cloud REST API.

Contribution

Please help to improve this documentation by sending a Pull request.

Tests

All new contributions should have its unit tests in /tests directory.

Before you send a PR, please, check all tests pass.

This package uses Nette Tester. You can run tests via command:

composer test

For benchmarking, we use phpbench. You can run benchmarks this way:

composer global require phpbench/phpbench @dev # only the first time
phpbench run

Before PR, please run complete code check via command:

composer cs:install # only first time
composer fix # otherwise pre-commit hook can fail