Mac/Windows Requirements

From OSUPDOCS
Jump to navigation Jump to search

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. clang-mp: Compling on a mac requires the clang-mp compiler. It is a separate install because it does not come with XCode.
  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. 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.
  5. 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.
  6. NairnFEAMPM. This application is for running and visualizing calculations on a Mac. It is not included in the project, but can be downloaded here.
  7. 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.
  8. Eclipse: A good option for recompiling your changes to NairnFEAMPMViz is to use Eclipse.
  9. Java: Eclipse has self-contained java tools, bvut if you want to be able to run Java applications outside of Eclipse, you will need a separate Java installation. Since 2019, getting Java from Oracle has be unclear and they want to pay $300 for licence. Furthermore, they do not appear to provide Java for the Mac M1 chips. A better and free options is to install Java from [https://www.azul.com/downloads/zulu-community/
Azul]. you can get man version 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)
  1. TexShop: This recommended software is needed if you want to edit the LaTeX technical notes in OSParticulas.

Windows Requirements

In Windows, you can try on calculations by downloading NairnFEAMPMViz (although you will also need to have Java 1.8.0 (a.k.a Java 8) or new installed. If you decide you want to get further into the project, such as adding you 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
  2. 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.
  3. 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.
  4. NairnFEAMPMViz. This application is for running and visualizing calculations on a Mac. It is not included in the project, but can be downloaded here. To use this application in Windows, you will need to have Java 1.8.0 (a.k.a Java 8) or newer installed.
  5. 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 NairnFEAMPMViz#Compiling the NairnFEAMPMViz Java Application compiling your changes is to use Eclipse.
  6. 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.
  7. KLatexFormula. One you have LaTex installed, this utility is nice option for typesetting equations to include in presentations you make about simulation results.
  8. Notepad++. This application is a power text editor with options for plug ins.