
      *****************************************************************
      *                                                               *
      *                      OptiVec for Delphi                       *
      *                                                               *
      *                         Demo Version 8                        *
      *****************************************************************

Contents:
     1. Introduction
     2. System requirements
     3. Installation
     4. Running the examples
     5. Documentation
     6. What's New?
     7. Copyright
     8. Registered Version


1. Introduction
---------------
Vector functions instead of loops - if it matters to you how fast and how
accurate your data are processed!
The largest portion of almost all programs processing numerical data
consists of loops. Replace these loops by the specialized vector
functions of OptiVec, and exploit all the advantages of vectorized
programming:

- OptiVec was almost entirely written in machine code. The result is a
  highly optimized and numerically accurate code, running much faster
  and often giving more accurate results than compiled loops.

- fully vectorized forms of all operators and functions of the language
  Pascal for all integer and floating-point (including complex!) data types

- Additionally many other real and complex math functions, statistics,
  analysis, FFT techniques, graphics - in total more than 3000!

- Simple and logical syntax, for example
  "VD_exp( Y, X, size );"      for Y[i] := exp( X[i] ) with "Double" arrays,
  "VE_FFT( Y, X, size, 1 );"   for extended-precision forward FFT

- Efficient matrix and curve-fitting routines


2. System requirements
----------------------
This version of OptiVec is designed for PC computers, running under
32-bit or 64-bit Windows and equipped at least with an AMD64x2 or
Intel Core2Duo CPU (the 32-bit libraries are back-compatible to 
Pentium / Athlon).
Depending on your choice when downloading or ordering, you got the
version for
Embarcadero (Borland) Delphi 2009, 2010, the XE series, 10.x 
(Seattle, Berlin, Tokyo, Rio, Sydney), 11.x (Alexandria), 12.x (Athens),
13.x (Florence).

If you need versions for other compilers, please visit 
https://www.optivec.com/download 

At present, OptiVec is available for the following target compilers:
Windows:
- C++ Builder  (Embarcadero RAD Studio; formerly Borland C++)
- Microsoft Visual C++
- GCC, the GNU Compiler Collection
- LLVM Clang
- Delphi (Embarcadero RAD Studio)
- Lazarus / FreePascal
Linux:
- GCC or CLang


3. Installation
---------------
a) To install OptiVec, you need to have administrator privileges.

b) To install the Demo version of OptiVec, you need to execute INSTALL.EXE,
   contained in the ZIP file you downloaded. Only then, programs using the
   OptiVec library can run. It is not possible to just copy the .dcu files, 
   e.g., from another computer.

c) In case you wish to install OptiVec for several Delphi versions
   (e.g., 10.3 and 11), these versions may be installed one after the other. 
   You need to choose a unique directory for each version.

d) Windows has a habit of sometimes warning users after the installation
   of third-party products: "Setup possibly incomplete". If INSTALL.EXE
   did finish and displayed this README.TXT file, you know that the
   installation is complete.

e) After you completed the installation, you must set the Units search path
   according to your OptiVec directory choice.
   To this end, open the menu
   "Project / Options / Directories and Conditionals" in the Delphi IDE.

   Say, your OptiVec directory is C:\OPTIVEC. Then, your 32-bit units search 
   path is  C:\OPTIVEC\LIB4D  for the LIB4D units (the ones we recommend to 
   start with)  or  C:\OPTIVEC\LIB8M  for the high-performance units.
   The 64-bit units are in C:\OPTIVEC\Win64\LIB8 (general purpose) and
   C:\OPTIVEC\Win64\LIB9M (high-performance for up-to-date processors).

   Add this path into the line "Search path".
   (Remember: a semicolon is used to separate entries in these fields.)

   You must do so for every project for which you wish to use OptiVec
   functions.

f) If you use the command-line compiler DCC32.EXE, you must
   add this path also in the configuration file, DCC32.CFG,
   or in the command line, like:

   dcc32 -u"c:\optivec\lib4d" vdemo.dpr


4. Running the examples
-----------------------
Check your installation by compiling and running the demo programmes

a) using the IDE:
    Open VDEMOD.groupproj

	This project group contains four projects:
		VDEMO:      basic use of vector functions
		VSpeedDemo: demonstration of speed-up through vector functions
		FITDEMO:    data fitting functions
		CDEMO:      complex-number math operations
		MANDEL:     simple modified Mandelbrodt implementation with CMATH
	
      - set the search path as described above
      - compile and run all four projects in turn.

b) using the command-line compiler:
      type
      DCC32 -u"C:\OPTIVEC\LIB4D" VDEMO.DPR

Similarly, try the other demos: FITDEMO.DPR, CDEMO.DPR, MANDEL.DPR

If you get errors like "Unknown Function ...", you probably did not set
the unit search path correctly.


5. Documentation
----------------
The full OptiVec documentation is to be found in the files
HANDBOOK.HTM, FUNCREF.HTM, MATRIX.HTM, and CMATH.HTM to be read with
an HTML browser like Edge, Chrome, or Opera.
Some older browser versions may crash when loading large HTML files 
like FUNCREF.HTM. If that happens, we recommend to use a more recent
browser version or the online documentation on https://www.optivec.com.


6. What's New?
--------------
Version 8.4.x:
  - Support for Delphi 13.x Florence

  - new functions:
    V?_isconst:  returns 1 (True), if all elements are equal
    V?_subvector_neg: inverts the sign of all elements of a subvector
	inverse hyperbolic functions, both real and complex:
	   VF_asinh, VF_acosh, VF_atanh
	   cf_asinh, cf_acosh, cf_atanh  (scalar)
	   VCF_asinh, VCF_acosh, VCF_atanh (vector)
	   and their double- and extended-precision analogues

  - 64-bit only:
    - Complete overhaul of the double-precision mathematical and statistical
      functions. The new implementations are much faster.
    
    - Overhaul of some complex-valued math functions:
      VCF_sqrt, VCF_exp, VCF_sin, VCF_cos, VCF_tan, VCF_sinh, VCF_cosh,
      VCF_tanh along with their VCFx_, VCD_, and VCDx_ counterparts.
      Also these new implementations are much faster. The remainder of the
      VCF_ and VCD_ functions will follow in coming releases.

    - in the CMATH part:
      Faster implementation of cf_sqrt, cf_exp, cf_sin, cf_cos, cf_tan,
      cf_sinh, cf_cosh, cf_tanh
    
    - bug fix in pf_powRe


For information on previous versions, see VersionHistory.txt.
   

7. Copyright
------------
The copyright owner of this product as a whole and of all its constituent
parts is
         OptiCode
         Dr. Martin Sander Software Development
         Brahmsstr. 6
         D-32756 Detmold
         Germany
         e-mail: optivec@gmx.de
         https://www.optivec.com

This Demo version of OptiVec is freely distributable in unchanged form.
For the distribution of applications created using OptiVec, you need the
registered version. The detailed licence terms are described in chapter 1.2
of the file HANDBOOK.HTM.


8. Registered Version
---------------------

If you like OptiVec and decide to use it, please be fair and register.

The registered Version of OptiVec for Delphi

-  supports Delphi 13.x, 12.x, 11.x, 10.x, XE series, 2010, 2009 for Win32 and Win64 

-  has individually optimized libraries for special high-performance
   techniques and for various degrees of processor backward-compatibility:

      "P10" (up-to-date 64-bit processors; will work down to
            Intel Core i Haswell+, AMD Steamroller+, but not Celeron etc.!):
            highest performance through AVX512 instructions, if available;
            if AVX512 is not avilable, AVX and AVX2 are employed.
      "P9" (will work down to Intel Core i Haswell+, AMD Steamroller+,
            but not Celeron etc.!):
            high performance through AVX and AVX2 instructions 
      "P8"  (Core2xxx+, AMD64x2+):
            uses SSE, SSE2, and SSE3 commands
      "P4", units using the FPU for maximum precision and
            safety of floating-point operations, back-compatible 
            to 486DX/Pentium/Athlon (32-bit only) 
      "Multi-core" (multi-core processors or multi-processor configurations):
            auto-threading libraries, gaining speed by distributing the work-
            load over the available processor cores
      "CUDA" (CUDA-enabled nVidia graphics card):
            libraries to be used on systems with an installed CUDA device,
            yielding highest performance for large vectors and matrices
      "Dimension-consistency debug" (32-bit: only P4;  64-bit: only P8).


-  entitles you to two years of free updates
   (by downloading from our web site)

-  costs:
                                 single-compiler         master licence for all
                                   licence                supported compilers         
      commercial licence         EUR  199.00                 EUR 299.00
      educational licence        EUR   99.00                 EUR 149.00

The above prices include 19% German VAT.
If you are ordering from outside the EU, or if you have a European VAT ID,
you are exempt from German VAT, and it will be deduced from your bill,
but you may have to pay your local VAT and/or import duties according to
local laws.

See www.optivec.com/order  for ordering options and volume discounts.     


    * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

Copyright (C) OptiCode - Dr. Martin Sander Software Dev. 1996-2026
