Skip to content

Commit d8badae

Browse files
committed
save
1 parent 1a718ec commit d8badae

5 files changed

Lines changed: 59 additions & 54 deletions

File tree

BENCHMARK_RESULTS.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# ParserNG 1.0.2 Official Benchmarks
1+
# ParserNG 1.0.0+ Official Benchmarks
22

33

44
### **ParserNG vs. The Giants: Master Performance Matrix**

LATEST.md

Lines changed: 14 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,30 @@
11
# ParserNG
22

3+
4+
### Parser 1.0.4 has been released on maven-central!
5+
This version features various optimizations and turbo capability for the Function
6+
class.
7+
38
Parser 1.0.3 has been released on maven-central!
49
Maintaining the industry standard besting speeds of v1.0.x, it adds the functionality of rotational geometry.
510
In v1.0.3, you can use the rotor function, `rot` to rotate raw points in 3D space and other functions such as curves, lines, surfaces(both plane and curved) and 3D equations of all sorts.
611

7-
ParserNG 1.0.2 has been released on maven-central!
12+
### ParserNG 1.0.2 has been released on maven-central!
813
Version 1.0.2 retains the wild speeds of Version 1.0.1. Adds an extra widening technique of variable passing to the Turbo mode,
914
In addition to the current method of array based passing. The widening technique can be sometimes faster than the array based methods,
1015
but their speed profiles and memory profiles are similar. Its weakness though is that it cannot use more than 63 variables per expression, whereas the array based approach allows in theory any number up to the max integer size.
1116

1217

13-
ParserNG 1.0.1 has been released on maven-central!
18+
### ParserNG 1.0.1 has been released on maven-central!
1419
This close update ensures that Turbo mode's memory profile stays close to that of the normal mode, which is, nigh zero.
1520

1621

17-
ParserNG 1.0.0 has been released on maven-central!
22+
### ParserNG 1.0.0 has been released on maven-central!
1823
The library has finally come of age with the introduction of its Turbo mode, which offers a massive speed boost over its normal mode.
1924
The nomal mode already beats famous libraries like exp4J, and rivals Janino, the widely acclaimed Gold Standard of Java math parser speed measurements, very closely
2025

2126

22-
ParserNG 0.2.5 has been released on maven-central
27+
### ParserNG 0.2.5 has been released on maven-central
2328

2429
1. Functions like `intg`, `root`, `t_root` and `quadratic` have been fixed and are working well. .
2530

@@ -31,18 +36,18 @@ ParserNG 0.2.5 has been released on maven-central
3136

3237
5. If you need a rich, fully featured parser that can do 3 million to 10 million evaluations per second, ParserNG v0.2.5 is the one for you.
3338

34-
ParserNG 0.2.4 has been released on maven-central!
39+
### ParserNG 0.2.4 has been released on maven-central!
3540

36-
ParserNG 0.2.4 drives the limits of expression interpretation velocity even further than all previous versions, beating many lighterweight and fast Java math parsers(interpreted) in many benchmarks.
41+
### ParserNG 0.2.4 drives the limits of expression interpretation velocity even further than all previous versions, beating many lighterweight and fast Java math parsers(interpreted) in many benchmarks.
3742
Check [ParserNG-Wars](https://github.com/gbenroscience/ParserNG) for some shootouts between ParserNG and other parsers, both handrafted benchmarks and JMH based ones
3843

3944
ParserNG evaluates expressions at almost the speed at which the expressions would run if they were compiled statements in Java code. Typical values for moderate expression evaluation speeds are between `85ns`(algebraic expressions e.g.`((12+5)*3 - (45/9))^2` to `176ns`(methods with trig. functions, e.g. `(sin(3) + cos(4 - sin(2))) ^ (-2))`.
4045

4146

4247
Applications that need 5 million to 10 million points generated per second would benefit from `ParserNG v0.2.4`
4348

44-
0.2.3
45-
**ParserNG 0.2.3** has been released on maven central!<br>
49+
50+
### **ParserNG 0.2.3** has been released on maven central!<br>
4651
comes with couple microsecond (on decent hardware and) expression solving ability while maintaining its full feature stack. Graphing feels butter-smooth and iterations shouldn't feel so iterative.
4752

4853
At 5 microsecond, moderately complex expressions such as
@@ -55,7 +60,7 @@ String s6 = "5*sin(3+2)/(4*3-2)";
5560

5661
Also, we support eigenvalues and eigenvectors as inbuilt methods, so enjoy!
5762

58-
ParserNG 0.2.2 has been released on maven-central!**
63+
### ParserNG 0.2.2 has been released on maven-central!**
5964

6065

6166
## What's new?

LOGICAL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -133,7 +133,7 @@ In CLI, you can use -e/-E/--expanding switch to work with Expanding expressions.
133133
<br>
134134
Example:<br>
135135
```
136-
VALUES_PNG="1 8 5 2" java -jar target/parser-ng-1.0.3.jar -e "avg(..L{MN/2})*1.1-MN < L0 | (L1+L{MN-1})*1.3 + MN< L0" -v
136+
VALUES_PNG="1 8 5 2" java -jar target/parser-ng-1.0.4.jar -e "avg(..L{MN/2})*1.1-MN < L0 | (L1+L{MN-1})*1.3 + MN< L0" -v
137137
avg(..L{MN/2})*1.1-MN < L0 | (L1+L{MN-1})*1.3 + MN< L0
138138
Expression : avg(..L{MN/2})*1.1-MN <L0 | (L1+L{MN-1})*1.3 + MN<L0
139139
Upon : 1,8,5,2

MORE.md

Lines changed: 29 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# ParserNG
2-
<b>ParserNG</b> is a powerful open-source math tool that parses and evaluates algebraic expressions and also knows how to handle a lot of mathematical expressions. Its latest release on mavn-central (version 1.0.31) can be used to plot 2D graphs(Geometric plots and function plots) It works seamlessly on all Java platforms.<br><br>
2+
<b>ParserNG</b> is a powerful open-source math tool that parses and evaluates algebraic expressions and also knows how to handle a lot of mathematical expressions. Its latest release on mavn-central (version 1.0.4) can be used to plot 2D graphs(Geometric plots and function plots) It works seamlessly on all Java platforms.<br><br>
33

44

55

@@ -8,15 +8,15 @@
88
Click the Sponsor button to do this.
99

1010

11-
ParserNG v1.0.3 breaks the barrier in fully featured math parser frequencies!
12-
With various other optimizations, v1.0.3 comes with inner loop optimizations which uses a blazing fast, post-fix style algorithm to quickly evaluate inner brackets with less checks and less string manipulations.
11+
ParserNG v1.0.4 breaks the barrier in fully featured math parser frequencies!
12+
With various other optimizations, v1.0.4 comes with inner loop optimizations which uses a blazing fast, post-fix style algorithm to quickly evaluate inner brackets with less checks and less string manipulations.
1313
This obviously will make graphing and other iterative tasks super responsive.
1414

15-
ParserNG v1.0.34 is an extremely feature rich math tool which also doubles as (arguably) the fastest pure Java expression evaluator on the planet.
15+
ParserNG v1.0.4 is an extremely feature rich math tool which also doubles as (arguably) the fastest pure Java expression evaluator on the planet.
1616
In benchmarks, it beats com.expression.parser(Java Math Expression Parser) by almost (10x-14x) and edges out Exp4J (which is lightweight) in many benchmarks.
1717

1818

19-
ParserNG 1.0.35 features strength reduction, constant folding and execution frame(array) based args passing(in contrast to Map based) to ensure O(1) complexity in passage of args to the evaluation stage.
19+
ParserNG 1.0.4 features strength reduction, constant folding and execution frame(array) based args passing(in contrast to Map based) to ensure O(1) complexity in passage of args to the evaluation stage.
2020

2121
[Here are a few benchmarks here](./BENCHMARK_RESULTS.md)
2222

@@ -68,7 +68,7 @@ If you need to access this library via Maven Central, do:
6868
<dependency>
6969
<groupId>com.github.gbenroscience</groupId>
7070
<artifactId>parser-ng</artifactId>
71-
<version>1.0.3</version>
71+
<version>1.0.4</version>
7272
</dependency>
7373
7474

@@ -101,20 +101,20 @@ ParserNG is written completely in (pure) Java and so is as cross-platform as Jav
101101
## Using ParserNG as commandline tool
102102
You can use jar directly as commandline calculus. Unless the tool is packed to your distribution:
103103
```
104-
java -jar parser-ng-1.0.3.jar 1+1
104+
java -jar parser-ng-1.0.4.jar 1+1
105105
2.0
106106
```
107107
Or as logical parser
108108
```
109-
java -jar parser-ng-1.0.3.jar -l true and true
109+
java -jar parser-ng-1.0.4.jar -l true and true
110110
true
111-
java -jar parser-ng-1.0.3.jar -l "2 == (4-2)"
111+
java -jar parser-ng-1.0.4.jar -l "2 == (4-2)"
112112
true
113113
```
114114
You can get help by
115115
```
116-
java -jar parser-ng-1.0.3.jar -h
117-
ParserNG 1.0.3 math.Main
116+
java -jar parser-ng-1.0.4.jar -h
117+
ParserNG 1.0.4 math.Main
118118
-h/-H/--help this text; do not change for help (witout dashes), which lists functions
119119
-v/-V/--verbose output is reprinted to stderr with some inter-steps
120120
-l/-L/--logic will add logical expression wrapper around the expression
@@ -136,11 +136,11 @@ java -jar parser-ng-1.0.3.jar -h
136136
```
137137
You can get examples by verbose help:
138138
```
139-
java -jar parser-ng-1.0.3.jar -h -v
139+
java -jar parser-ng-1.0.4.jar -h -v
140140
```
141141
you can list functions:
142142
```
143-
java -jar parser-ng-1.0.3.jar help
143+
java -jar parser-ng-1.0.4.jar help
144144
List of currently known methods:
145145
acos - help not yet written. See https://github.com/gbenroscience/ParserNG
146146
...
@@ -149,7 +149,7 @@ List of functions is just tip of iceberg, see: https://github.com/gbenroscience/
149149
```
150150
you can list logical operators:
151151
```
152-
java -jar parser-ng-1.0.3.jar -l help
152+
java -jar parser-ng-1.0.4.jar -l help
153153
Comparing operators: !=, ==, >=, <=, le, ge, lt, gt, <, >
154154
Logical operators: impl, xor, imp, eq, or, and, |, &
155155
As Mathematical parts are using () as brackets, Logical parts must be grouped by [] eg.
@@ -164,40 +164,40 @@ Program can work with stdin, out and err properly. Can work with multiline input
164164
### cmdline examples
165165
Following lines describes, how stdin/arguments are processed, and how different is input/output with `-t` on/off
166166
```
167-
java -jar parser-ng-1.0.3.jar -h
167+
java -jar parser-ng-1.0.4.jar -h
168168
this help
169-
java -jar parser-ng-1.0.3.jar 1+1
169+
java -jar parser-ng-1.0.4.jar 1+1
170170
2.0
171-
java -jar parser-ng-1.0.3.jar "1+1
171+
java -jar parser-ng-1.0.4.jar "1+1
172172
+2+2"
173173
2.0
174174
4.0
175-
java -jar parser-ng-1.0.3.jar -t "1+1
175+
java -jar parser-ng-1.0.4.jar -t "1+1
176176
+2+2"
177177
6.0
178-
java -jar parser-ng-1.0.3.jar -i 1+1
178+
java -jar parser-ng-1.0.4.jar -i 1+1
179179
nothing, will expect manual output, and calculate line by line
180-
java -jar parser-ng-1.0.3.jar -i -t 1+1
180+
java -jar parser-ng-1.0.4.jar -i -t 1+1
181181
nothing, will expect manual output and calcualte it all as one expression
182-
echo 2+2 | java -jar parser-ng-1.0.3.jar 1+1
182+
echo 2+2 | java -jar parser-ng-1.0.4.jar 1+1
183183
2.0
184184
echo "1+1
185-
+2+2 | java -jar parser-ng-1.0.3.jar -i
185+
+2+2 | java -jar parser-ng-1.0.4.jar -i
186186
2.0
187187
4.0
188188
echo "1+1
189-
+2+2 | java -jar parser-ng-1.0.3.jar -i -t
189+
+2+2 | java -jar parser-ng-1.0.4.jar -i -t
190190
6.0
191-
java -cp parser-ng-1.0.3.jar parser.cmd.ParserCmd "1+1
191+
java -cp parser-ng-1.0.4.jar parser.cmd.ParserCmd "1+1
192192
will ask for manual imput en evaluate per line
193193
echo "1+1
194-
+2+2 | java -cp parser-ng-1.0.3.jar parser.cmd.ParserCmd 2>/dev/null
194+
+2+2 | java -cp parser-ng-1.0.4.jar parser.cmd.ParserCmd 2>/dev/null
195195
2.0
196196
4.0
197-
java -cp parser-ng-1.0.3.jar parser.MathExpression "1+1
197+
java -cp parser-ng-1.0.4.jar parser.MathExpression "1+1
198198
+2+2"
199199
6.0
200-
java -cp parser-ng-1.0.3.jar parser.LogicalExpression "true or false"
200+
java -cp parser-ng-1.0.4.jar parser.LogicalExpression "true or false"
201201
true
202202
203203
```
@@ -773,7 +773,7 @@ This would give:
773773

774774
#### ParserNG and eigenvalues
775775

776-
Version 1.0.3 of ParserNG allows you to quickly compute the eigenvalues of a Matrix.
776+
Version 1.0.4 of ParserNG allows you to quickly compute the eigenvalues of a Matrix.
777777

778778
Do:
779779
```Java
@@ -782,7 +782,7 @@ Do:
782782
```
783783
#### ParsrNG and eigenvectors
784784

785-
As of ParserNG 1.0.3 also, eigenvector computations have been added, do:
785+
As of ParserNG 1.0.4 also, eigenvector computations have been added, do:
786786
Do:
787787
```Java
788788
MathExpression expression = new MathExpression("eigvec(@(5,5)(12,1,4,2,9,3,1,8,-5,6,13,9,7,3,5,7,3,5,4,9,13,2,4,8,6))");

README.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# ParserNG 🧮⚡
22

3-
**ParserNG 1.0.3** is a **blazing-fast**, nigh zero allocation(memory wise), **pure Java**, **zero-native-dependencies** math expression parser and evaluator.
3+
**ParserNG 1.0.4** is a **blazing-fast**, nigh zero allocation(memory wise), **pure Java**, **zero-native-dependencies** math expression parser and evaluator.
44

55
It **beats exp4J, and com.expression.parser on evaluation speed** across every kind of expression — from simple algebra to heavy trig, matrices, and calculus; and manages to beat Janino, the gold standard on some, while rivalling it on a host of other expressions
66
The normal mode routinely does about **3-10 million evaluations per second** while the new Turbo mode easily peaks at about **10 million to 90 million evaluations per second**.
@@ -12,11 +12,11 @@ Perfect for scientific computing, simulations, real-time systems, education tool
1212
[![Maven Central](https://img.shields.io/maven-central/v/com.github.gbenroscience/parser-ng.svg?label=Maven%20Central)](https://central.sonatype.com/artifact/com.github.gbenroscience/parser-ng)
1313
[![License](https://img.shields.io/github/license/gbenroscience/ParserNG?color=blue)](https://github.com/gbenroscience/ParserNG/blob/master/LICENSE)
1414
![Java](https://img.shields.io/badge/Java-8%2B-orange)
15-
![Latest Version](https://img.shields.io/badge/version-1.0.3-success)
15+
![Latest Version](https://img.shields.io/badge/version-1.0.4-success)
1616

17-
> **1.0.3** introduces **Turbo Scalar** and **Turbo Matrix** compiled paths + massive speed improvements via strength reduction, constant folding, and O(1) frame-based argument passing.
17+
> **1.0.4** introduces **Turbo Scalar** and **Turbo Matrix** compiled paths + massive speed improvements via strength reduction, constant folding, and O(1) frame-based argument passing.
1818
19-
## ✨ Highlights (v1.0.3)
19+
## ✨ Highlights (v1.0.4)
2020

2121
- **Speed champion** — rivals Janino in most benchmarks, and beats exp4J, com.expression.parser and Parsii in every benchmark (see [BENCHMARK_RESULTS.md](BENCHMARK_RESULTS.md))
2222
- **Turbo Mode** — compile once, evaluate millions of times per second (Scalar + Matrix paths)
@@ -36,14 +36,14 @@ Perfect for scientific computing, simulations, real-time systems, education tool
3636
<dependency>
3737
<groupId>com.github.gbenroscience</groupId>
3838
<artifactId>parser-ng</artifactId>
39-
<version>1.0.3</version>
39+
<version>1.0.4</version>
4040
</dependency>
4141
```
4242

4343
Also available on **Maven Central**:
44-
https://central.sonatype.com/artifact/com.github.gbenroscience/parser-ng/1.0.3
44+
https://central.sonatype.com/artifact/com.github.gbenroscience/parser-ng/1.0.4
4545

46-
## ⚡ Turbo Mode — The 1.0.3 Game Changer
46+
## ⚡ Turbo Mode — The 1.0.4 Game Changer
4747

4848
```java
4949
import com.github.gbenroscience.parser.MathExpression;
@@ -158,10 +158,10 @@ with the directio vector,(1,1,0). The angle of rotation is pi radians.
158158
## ⌨️ Command-line tool (REPL)
159159

160160
```bash
161-
java -jar parser-ng-1.0.3.jar "sin(x) + cos(x)"
162-
java -jar parser-ng-1.0.3.jar "eigvalues(R=@(5,5)(...))"
163-
java -jar parser-ng-1.0.3.jar help
164-
java -jar parser-ng-1.0.3.jar -i # interactive mode
161+
java -jar parser-ng-1.0.4.jar "sin(x) + cos(x)"
162+
java -jar parser-ng-1.0.4.jar "eigvalues(R=@(5,5)(...))"
163+
java -jar parser-ng-1.0.4.jar help
164+
java -jar parser-ng-1.0.4.jar -i # interactive mode
165165
```
166166

167167
## 📊 Supported Features at a Glance
@@ -182,8 +182,8 @@ Full list: run `help` or `new MathExpression("help").solve()`.
182182

183183
- [BENCHMARK_RESULTS.md](BENCHMARK_RESULTS.md) — full speed comparisons
184184
- [GRAPHING.md](GRAPHING.md) — plotting on Swing / JavaFX / Android
185-
- [LATEST.md](LATEST.md) — what’s new in 1.0.3
186-
- Javadoc: https://javadoc.io/doc/com.github.gbenroscience/parser-ng/1.0.3
185+
- [LATEST.md](LATEST.md) — what’s new in 1.0.4
186+
- Javadoc: https://javadoc.io/doc/com.github.gbenroscience/parser-ng/1.0.4
187187

188188
## ❤️ Support the Project
189189

@@ -200,7 +200,7 @@ ParserNG is built with love in my free time. If it helps you:
200200

201201
---
202202

203-
**ParserNG 1.0.3** — faster than the competition, stronger on matrices, and now with real Turbo Scalar + Turbo Matrix compiled power.
203+
**ParserNG 1.0.4** — faster than the competition, stronger on matrices, and now with real Turbo Scalar + Turbo Matrix compiled power.
204204

205205
Happy parsing! 🚀
206206
**GBENRO JIBOYE** (@gbenroscience)

0 commit comments

Comments
 (0)