McXtrace - An X-ray ray-trace simulation package

B.  Libraries and conversion constants

The McXtrace Library contains a number of built-in functions and conversion constants which are useful when constructing components. These are stored in the share directory of the MCXTRACE library.

Within these functions, the ’Run-time’ part is available for all component/instrument descriptions. The other parts are dynamic, that is they are not pre-loaded, but only imported once when a component requests it using the %include McXtrace keyword. For instance, within a component C code block, (usually SHARE or DECLARE):

1    %include "read_table-lib"

will include the ’read_table-lib.h’ file, and the ’read_table-lib.c’ (unless the --no-runtime option is used with mcxtrace). Similarly,

1    %include "read_table-lib.h"

will only include the ’read_table-lib.h’. The library embedding is done only once for all components (like the SHARE section). For an example of implementation, see Res_monitor.

In this Appendix, we present a short list of both each of the library contents and the run-time features.