Skip to content

Commit 0fba15e

Browse files
authored
Update README.md
1 parent e0db01b commit 0fba15e

File tree

1 file changed

+35
-4
lines changed

1 file changed

+35
-4
lines changed

README.md

Lines changed: 35 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,11 +3,35 @@
33
[![GitHub](https://img.shields.io/github/license/ws-garcia/VBA-Expressions?style=plastic)](https://github.com/ws-garcia/VBA-Expressions/blob/master/LICENSE) [![GitHub release (latest by date)](https://img.shields.io/github/v/release/ws-garcia/VBA-Expressions?style=plastic)](https://github.com/ws-garcia/VBA-Expressions/releases/latest) [![Mentioned in Awesome VBA](https://awesome.re/mentioned-badge.svg)](https://github.com/sancarn/awesome-vba)
44

55
## Introductory words
6-
VBA Expressions is a powerful string expression evaluator for VBA and [LO Basic](https://extensions.libreoffice.org/en/extensions/show/70059), which puts more than 100 mathematical, statistical, financial, date-time, logic and text manipulation functions at the user's fingertips. The `VBAexpressions.cls` class mediates almost all VBA functions as well as custom functions exposed through it.
7-
8-
Although the main development goal of the class was the integration with [CSV Interface](https://github.com/ws-garcia/VBA-CSV-interface), VBA Expressions has evolved to become a support tool for students and teachers of science, accounting, statistics and engineering; this due to the added capability to solve systems of equations and non-linear equations in one variable.
9-
6+
Welcome to VBA Expressions, a powerful library designed to extend the capabilities of Visual Basic for Applications (VBA) within Microsoft Office and [LibreOffice environments](https://extensions.libreoffice.org/en/extensions/show/70059). This tool enriches the standard VBA language and LO BASIC with an extensive set of functions for data manipulation, calculation, and analysis, making it ideal for users needing to perform complex operations directly within their spreadsheets, documents, presentatios and much more.
107
## ![User Manual](/docs/assets/img/VBAExprManual.pdf)
8+
## Key features
9+
* __Extensive Function Library__: Includes over 100 functions spanning:
10+
* Mathematical operations
11+
* Statistical analysis
12+
* Financial calculations
13+
* String and date-time manipulations
14+
* __User-Defined Functions (UDFs)__: Create custom functions to meet specific business or analytical needs.
15+
* __Matrix Support__: Handle matrices for advanced mathematical computations or data transformations.
16+
* __Seamless VBA and LO BASIC Integration__: Works directly within VBA and LO BASIC scripts, allowing for automation of complex tasks in Microsoft Excel, Access, Word, and LibreOffice.
17+
18+
## Use cases
19+
### Data Management and Analysis
20+
* __CSV Data Processing__:
21+
* Filter, join, and transform CSV data directly within VBA and LO BASIC scripts, as seen with the [CSV Interface library](https://github.com/ws-garcia/VBA-CSV-interface)
22+
* __Dynamic Reporting__:
23+
* Generate dynamic reports by combining data from multiple sources and applying complex filters or calculations.
24+
### Financial Analysis
25+
* __Investment Analysis__: Use financial functions for NPV, IRR, or other investment metrics calculations directly within your code on all supported office ecosystem.
26+
* __Portfolio Management__: Manage and analyze financial data sets with custom calculations for performance metrics.
27+
### Scientific and Engineering Calculations
28+
* __Matrix Operations__: Solve linear systems, perform matrix multiplication for data modeling or simulation.
29+
* __Statistical Analysis__: Conduct statistical tests or data fitting within your Office tools without external software.
30+
### Educational and Technical Documentation
31+
* __Interactive Documents__: Embed calculations or data transformations in educational materials or technical documentation for live demos or explanations.
32+
### Automation of Repetitive Tasks
33+
* __Data Cleaning__: Automate data normalization, cleaning, or validation processes.
34+
* __Batch Processing__: Handle batch operations on data, like updating datasets with new calculations or conditions.
1135

1236
## Advantages
1337
* __Easy to use and integrate__.
@@ -338,6 +362,13 @@ End Sub
338362
''' SWITCH(x='Asia';1;x='Africa';2;x='Oceania';3) = 1 for x = 'Asia'
339363
'@------------------------------------------------------
340364
```
365+
## Contributing
366+
We welcome contributions to enhance VBA Expressions. Whether it's new functions, bug fixes, or documentation improvements, your input can help make this tool even more powerful:
367+
* Fork the repository.
368+
* Make your changes or additions.
369+
* Submit a pull request.
370+
## Support
371+
For issues, feature requests, or questions, please use the issue tracker on GitHub. We're also open to discussions or contributions to our wiki for more use cases and tutorials.
341372
## Credits
342373
- [x] **Inquisitive knight**: new logo design. Awesome job!
343374

0 commit comments

Comments
 (0)