Computing Engine - Setup & Rules
This is the first section of the in-depth documentation of ILNumerics Computing Engine. For a quick basic introduction go here. To learn everything read on!
On Windows computers and when using the ILNumerics installer, ILNumerics modules are installed into the GAC. From your project, reference the ILNumerics.Core module. This module is always required. In order to write mathematical algorithms include the ILNumerics.Computing module and (optionally) the ILNumerics.numpy module too. Toolboxes come as individual modules which are referenced as required.
Useful Namespaces and imports
The following directives should be added at the beginning of your code files. They save a bunch of namespace and class specifiers and make your code a lot more readable. Note that most of our code examples throughout this documentation expect those directives to exist in order for the snippet to compile.
...and for Visual Basic:
Limitations on C# language features
Before learning the details of what can be done with ILNumerics, let's accept some limitations! The following features of the C# language are not compatible with the array types of ILNumerics and their use is not supported:
- The C#
varkeyword in conjunction with any ILNumerics array type, and
- Any compound operator, like
+=, -=, /=, *=and so on. To be precise, these operators are not allowed in conjunction with the indexer on arrays. So A += 1;is allowed. A += 1;is not! If you find this rule too hard to remember, we suggest not to use compound operators at all.
Limitations on Visual Basic language features
The type for all arrays must be defined explicitely. Just like the
Function Rules - Overview
Performance is made out of only three simple rules! They are described in detail in the next section and summarized in the following example function:
Essential function rules of ILNumerics: The first rule declares specific array types for input parameters and return values in function declarations. The second rule creates artificial scopes around the function body and the third rule handles assignments to output parameters.