Configuring and running FIA
FIA can be configured in two ways, depending on how you want to call the program:
Calling FIA from the command line
The simplest and quickest way to get going with FIA is to run in stand-alone mode from the command prompt. This requires
- data files;
- a configuration file
With these you can start generating attribution analyses immediately, using the supplied fia64 program.
fia64 is a simple program that reads in the supplied data and configuration settings, passes them through to the Flametree engine using its API, and generates reports.
All output is in the form of Excel or CSV files, as specified in the configuration settings.
Calling FIA from code
To call FIA from code, the information required is almost exactly the same as for stand-alone mode. The main differences are
- data must be supplied as in-memory arrays rather than CSV files, using string_matrix() structures
- configuration settings are assigned using function calls, rather than by assinging values in a configuration file
- some code is required to pull everything together.
In general, a program that calls FIA has the following form:
- Required program dependencies are loaded
- FIA data structures are loaded
- The program is initialized, via a call to FIA_init(). This ensures that all variables are assigned appropriate default values if not set by the user.
- Variables and data are initialized via calls to FIA_set_matrix, FIA_set_string, FIA_set_double, FIA_set_integer
- FIA is run via a call to FIA_run()
- Results are either written to disk as reports, or read back into a string_matrix structure via a call to FIA_get_matrix for subsequent use elsewhere.
If the language you wish to use is not shown here, please contact Flametree support.
Values of the configuration constants are supplied in file FIA_API_CONSTANTS.py (for Python), FIA_API_CONSTANTS.cs (for C#), and FIA_API_CONSTANTS.java (for Java). These files are always supplied with the run-time files for FIA.