The configuration file
The configuration file is a short text file that contains the names of the files to be used in the attribution calculation, the type of attribution to be performed, and any other information required for the analysis, such as the base currency for the final reports. A configuration file must be supplied each time FIA is run.
A configuration file allows the user to set large numbers of parameters without having to retype them each time the program is run.
Configuration files may be given any name, but must have the suffix cnf. Configuration files may be written or edited using any text editor, such as Notepad (in Windows) or gedit (in Linux).
A sample configuration file looks as follows:
# sample.cnf [FIA] PortfolioFile = statfund1.csv SecurityFile = sec_defs.csv CarryDecomposition = pull_to_par SovereignCurveDecomposition = STB RollDownAttribution = n DateFormat = %d/%m/%Y
This file specifies that
- the portfolio data file to be analyzed is called statfund1.csv;
- the benchmark associated with the portfolio is unspecified. In this case, no benchmark will appear in the final results;
- no exchange rate attribution is to be performed;
- return due to carry return is to be shown in the final report;
- changes in the sovereign yield curve for all markets are to be broken down into parallel shift, twist, and curvature components;
- credit curve attribution is to be run, using the AAA, Aa2 and A2 curves;
- roll-down effects are not to be calculated, but will instead be added to the residual return;
- dates will be read in the dd/mm/yyyy format.
The user has left a comment on the first line that the name of the file is sample.cnf. Any line that is prefixed by a # symbol is treated as a comment, and is ignored by FIA.
A detailed list of the possible options specified in the configuration file is shown in the next table. Note that many settings do not need to have values assign, as sensible default values are defined.
A configuration file must always start with [FIA].
If an option setting does not correspond to a defined field, FIA flags an error and stops.
Portfolios that are regularly analysed may be assigned their own configuration file. This file can then be reused as often as required.
Options may be set in any order.
Options are case-sensitive.
Setting up a configuration file
There are two ways to set up a configuration file for FIA.
- The first is to construct it manually using a text editor. For users who want to follow this route, full documentation is provided below.
- The second is to construct it using our freely downloadable graphical user interface (see Using the configuration GUI), which allows you to set up configuration files using drop-down menus and similar controls.
Setting up values
For string-valued options, use the pattern
VALUE can be upper or lower case.
For Boolean-valued options, use the pattern
where VALUE can take the values True, False, Yes, No, 1, 0.
Some fields can also be integer and real-valued.
No quotation marks are needed. Spaces to either side of the ‘=’ sign are ignored.
If a field is specified that is not recognised by FIA, the program will stop with an error message.