From e519934fce5ed2e2f3e303320a7e717a3b11cfb2 Mon Sep 17 00:00:00 2001 From: mrxrsd Date: Sat, 24 Apr 2021 10:29:09 -0300 Subject: [PATCH] Update README.md --- README.md | 28 ---------------------------- 1 file changed, 28 deletions(-) diff --git a/README.md b/README.md index 13ed46b..2e5b8ef 100644 --- a/README.md +++ b/README.md @@ -9,30 +9,12 @@ Original Project: [Jace](https://github.com/pieterderycke/Jace) # Jace.NET Jace.NET is a high performance calculation engine for the .NET platform. It stands for "Just Another Calculation Engine". -## Build Status -* [![Build status](https://ci.appveyor.com/api/projects/status/0qas60k4tlhi2b1d/branch/master?svg=true)](https://ci.appveyor.com/project/pieterderycke/jace/branch/master) (master) -* [![Build status](https://ci.appveyor.com/api/projects/status/0qas60k4tlhi2b1d/branch/dev?svg=true)](https://ci.appveyor.com/project/pieterderycke/jace/branch/dev) (dev) ## What does it do? Jace.NET can interprete and execute strings containing mathematical formulas. These formulas can rely on variables. If variables are used, values can be provided for these variables at execution time of the mathematical formula. Jace can execute formulas in two modes: in interpreted mode and in a dynamic compilation mode. If dynamic compilation mode is used, Jace will create a dynamic method at runtime and will generate the necessary MSIL opcodes for native execution of the formula. If a formula is re-executed with other variables, Jace will take the dynamically generated method from its cache. It is recommended to use Jace in dynamic compilation mode. -## Wiki -For detailed information how to use Jace.NET, please consult the [wiki](https://github.com/pieterderycke/Jace/wiki) - -## Architecture -Jace.NET follows a design similar to most of the modern compilers. Interpretation and execution is done in a number of phases: - -### Tokenizing -During the tokenizing phase, the string is converted into the different kind of tokens: variables, operators and constants. -### Abstract Syntax Tree Creation -During the abstract syntax tree creation phase, the tokenized input is converted into a hierarchical tree representing the mathematically formula. This tree unambiguously stores the mathematical calculations that must be executed. -### Optimization -During the optimization phase, the abstract syntax tree is optimized for executing. -### Interpreted Execution/Dynamic Compilation -In this phase the abstract syntax tree is executed in either interpreted mode or in dynamic compilation mode. - ## Examples Jace.NET can be used in a couple of ways: @@ -81,16 +63,6 @@ var engine = CalculationEngine.New() double result = engine.Calculate("logn(var1,var2)+4", variables); ``` -## Performance -Below you can find the results of Jace.NET benchmark that show its high performance calculation engine. Tests were done on an Intel i7 2640M laptop. -1000 random formulas were generated, each containing 3 variables and a number of constants (a mix of integers and floating point numbers). Each random generated formula was executed 10 000 times. So in total 10 000 000 calculations are done during the benchmark. You can find the benchmark application in "Jace.Benchmark" if you want to run it on your system. - -* Interpreted Mode : 00:00:06.7860119 -* Dynamic Compilation Mode: 00:00:02.5584045 - -## Compatibility -If you are using Jace.NET inside a Unity project using IL2CPP you must use Jace.NET in interpreted mode due to limitations of IL2CPP with dynamic code generation. - ## More Information For more information, you can read the following articles: * http://pieterderycke.wordpress.com/2012/11/04/jace-net-just-another-calculation-engine-for-net/