Compile the Code Engines
After checking out the nairn-mpm-fea project, the next step is to compile it. All code-engine source code is standard C++ and it should be possible to compile on a variety of systems. This page gives details on some common systems. Users are responsible for compilation on other systems.
MacOS X Compiling
Using XCode
Most development of OSParticulas and NairnFEA is done in MacOS X and thus compiling on MacOS X is easy. The preferred method is to use XCode (a command-line method is described below). A complete XCode project is located at
nairn-mpm-fea/Common/Projects/NairnMPM.xcodeproj
This project is called NairnMPM</t>, but it includes all MPM and FEA source code in two targets named NairnMPM and NairnFEA. To compile either one, select the target for the menu and using the Build menu command.
Compiling Xerces on MacOS X
Before you can compile and run the project, however, you will need an installed version of the xerces library and a copy of the xerces header files. The XCode project and command-line method below both assume they are installed in the default locations for MacOS X or at
/usr/local/lib/libxerces-c.dylib
for the library and at
/usr/local/include
for the header files. These can be changed if needed by editing the project and target settings. Since revision 274 of the nairn-mpm-fea project, this library must be xerces 3.0</t> or newer; prior to that revision, it had be xerces 2.8</t> or older. These libraries can be obtained by downloading the
| xerces source code from the | Apache Software Foundation web site and then building and installing xerces with the following steps (after seeing potential startup issues on Lion or newer systems):
- Open Terminal app and navigate to the xerces source folder expanded from the downloaded file.
- Configure the code with the command:
./configure CFLAGS="-arch x86_64" CXXFLAGS="-arch x86_64"
where the provided arch (or architecture) is the desired option for your machine. The main Mac options are i386 for 32 bit Intel processors, x86_64 for 64 bit Intel processors, ppc for 32 bit PowerPC chips, or ppc64 for 64 bit PowerPC64 chips. Although i386 will work on any Intel processor, you should use x86_64 if you have a 64 bit processor, because the code will run faster. To determine how many bits your Intel chip has, chose "About This Mac" from the Apple menu, click "More Info..." button, and look up the processor name in the hardware section. The "Intel Core Solo" and "Intel Core Duo" are 32 bit chips and most others are 64 bit chips.
- When the configuration is done, use the following commands:
cd src make make install
These command make the library (but not the unneeded xerces examples). The final install command after make is done, installs both the library and the header files at the default locations listed above. If the 'make install' shows a permission error, you can solve that by using 'sudo make install</t>' instead and provide your administrator password.
- When working with nairn-mpm-fea on a new Mac, the xerces installation only needs to be done once. The only reason to repeat it is when a new xerces version is available and/or the project requires a new version for compatibility.