Mac/Windows Requirements

Use of this project on Mac and Windows requires more than just a basic computer. This section list some other software that is essential, or recommended, for using this software.

MacOS Requirements

The following installations are recommended (or required) when using MacOS

1. XCode:Tthe best way to compile on MacOS is to use XCode. It is available for download on the Mac App Store. See compiling help for more details on installing and using XCode.
2. Xerces: Running and compiling this project requires the xerces library for parsing of XML files. Installation instructions on give in Compile the Code Engines.
3. clang-mp: Compling on a Mac requires the clang-mp compiler. It is a separate install because it does not come with XCode.
4. Github: The nairn-mpm-fea project is hosted on Github. Please see github.com for system-specific details and for installation of any needed tools. The software is used to clone the entire nairn-mpm-fea project.
5. Subversion: If you are working on OSParticulas, that project is hosted on a private server and checkout is done using svn (or Subversion). Prior to MacOS Big Sur, svn was automatically installed when you install XCode and activate command line tools. Although Apple deleted svn in Big Sur, it can be installed separately.
6. Versions: This software provides a visual interface to using svn while working with OSParticulas. If fact, it can do most svn tasks without even needing to install Subversion in Big Sur (or newer). If you need the command-line options it cannot handle, you may need to install svn separately.
7. NairnFEAMPM. This application is for running and visualizing calculations on a Mac. It is not included in the project, but can be downloaded here.
8. NairnFEAMPMViz. An alternative to NairnFEAMPM is to use the Java app NairnFEAMPMViz. The only reason to use this option on a Mac is because the project has complete source code for NairnFEAMPMViz. You can work with source code to add new features if desired.
9. Eclipse. The project has complete source code for NairnFEAMPMViz. You can work with source code to add new features if desired. A good option for compiling your changes is to use Eclipse.
10. Java: You can run Java applications within Eclipse, but if you want to be able to run Java applications on their own, you will need a separate Java installation. Since 2019, getting Java from Oracle has been unclear and they want you to pay $300 for license. Furthermore, they do not appear to provide Java for the Mac M1 chips (ARM architecture). A easy and free option is to install Java from Azul. You can get many versions and pick the one right for your processor. For now, NairnFEAMPMViz is written using Java 8 (a.k.a 1.8), but it should run in any newer version. If you are only running Java applications, you only need install the run-time environment (JRE).
11. TexShop: This recommended software is needed if you want to edit the LaTeX technical notes in OSParticulas.

Windows Requirements

In Windows, you can try out calculations by downloading just NairnFEAMPMViz. If you decide you want to get further into the project, such as adding your own features or revising the visualization tools, you will need to download source code. When working with project source code in Windows, the following installations are recommended:

1. Visual Studio: Compiling in Windows is done use community version of Visual Studio (it is a very large download).
2. Xerces: Running and compiling this project requires the xerces library for parsing of XML files. Installation instructions on give in Compile the Code Engines.
3. Github: The nairn-mpm-fea project is hosted on Github. Please see github.com for system-specific details and for installation of any needed tools. The software is used to clone the entire nairn-mpm-fea project.
4. TortoiseSVN: If you are working on OSParticulas, that project is hosted on a private server and checkout is done using svn (or Subversion). A good option for Windows is TortoiseSVN.
5. NairnFEAMPMViz: This application is for running and visualizing calculations on a Mac. The source code and a jar file are in project download. Alternatively, you can run calculations without even downloading project by downloading a package here.
6. Java: You will need to have Java 1.8.0 (a.k.a Java 8) or newer installed to run NairnFEAMPMViz. Since 2019, getting Java from Oracle has been unclear and they want you to pay $300 for license. A easy and free option is to install Java from Azul. You can get many versions and pick the one right for your processor. For now, NairnFEAMPMViz is written using Java 8 (aka 1.8), but it should run in any newer version. If you are only running Java applications, you only need install the run-time environment (JRE).
7. Eclipse. The project has complete source code for NairnFEAMPMViz. You can work with source code to add new features if desired. A good option for compiling your changes is to use Eclipse.
8. Texmaker. This recommended software is needed if you want to edit the LaTeX technical notes in OSParticulas. Texmaker needs a separate installation of LaTex and MikTeX is a good option.
9. KLatexFormula. One you have LaTex installed, this utility is nice option for typesetting equations to include in presentations you make about simulation results.
10. Notepad++. This application is a power text editor with options for plug ins.