|
3 | 3 | [](https://github.com/ws-garcia/VBA-Expressions/blob/master/LICENSE) [](https://github.com/ws-garcia/VBA-Expressions/releases/latest) [](https://github.com/sancarn/awesome-vba) |
4 | 4 |
|
5 | 5 | ## 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. |
10 | 7 | ##  |
| 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. |
11 | 35 |
|
12 | 36 | ## Advantages |
13 | 37 | * __Easy to use and integrate__. |
@@ -338,6 +362,13 @@ End Sub |
338 | 362 | ''' SWITCH(x='Asia';1;x='Africa';2;x='Oceania';3) = 1 for x = 'Asia' |
339 | 363 | '@------------------------------------------------------ |
340 | 364 | ``` |
| 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. |
341 | 372 | ## Credits |
342 | 373 | - [x] **Inquisitive knight**: new logo design. Awesome job! |
343 | 374 |
|
|
0 commit comments