Skip to content

Getting started

Antoine Tran edited this page Aug 11, 2019 · 29 revisions

Atosym

Atosym is an open-source, flexible and user-friendly library that is designed for numeric/algebraic expressions parsing.

Every string input is organized through the binary tree algorithm (which will be replaced by a more suitable AST in the future), a procedure that consists of splitting an expression into different branches so that one problem can be divided and treated more easily.


To better understand how Atosym works, you should know about what it is made of.

There are three main systems composing the library:

  • The Operation system
  • The Structure system
  • The Alteration system


As its title suggests, the operation system takes care of the different calculations you can perform involving a single mathematical expression (+ potential extra data). The operations handled by the library are the following:

  • Expression reduction
    • Extra data : None
  • Expression expansion
    • Extra data : None
  • Derivative calculation
    • Extra data: The unknown of the function
  • Image of function calculation
    • Extra data: Mapped unknown and values

On the other hand, the structure system handles the calculations implying several expression (+ potential extra data).
Unfortunately, there is no feature from this system available yet. Equations and compositions of functions will be added in the future.


Eventually, the alteration system takes care of two principal actions :

1. Input / Output modification
2. Calculation canceling

These actions allow the user to define calculation options through the different steps of an operation.
See Alterations for further information.


Now that you theoretically know how Atosym operates, it is time to jump into real code!
The Expression parsing page is a great place to start.