Difference between revisions of "NairnFEAMPM"

From OSUPDOCS
Jump to navigation Jump to search
 
(65 intermediate revisions by the same user not shown)
Line 1: Line 1:
<tt>NairnFEAMPM</tt> is a Mac-only application to create simulations, run them, and visualize them.
<b>NairnFEAMPM</b> is a Mac application to run finite element analysis (FEA) and material point method (MPM) calculations. The application contains all binary code engines and third-party libraries required to run calculations without need to build and source code and install any other tools. <b>NairnFEAMPM</b> is being developed by [http://www.cof.orst.edu/cof/wse/faculty/Nairn/ Prof. John A. Nairn] from the Wood Science and Engineering Department Oregon State University. This application is free but it is a dynamic work in progress as part of an active research program. If you are not using a Mac, you can do almost the same things using the Windows application [[NairnFEAMPMViz]].
 
== Introduction ==
 
The <tt>NairnFEAMPM</tt> application is finite element and material point method analysis software for the Macintosh. <tt>NairnFEAMPM</tt> is being developed by [http://www.cof.orst.edu/cof/wse/faculty/Nairn/ Prof. John A. Nairn] from the Wood Science and Engineering Department Oregon State University. This application is free but it is a dynamic work in progress as part of an active research program.
 
If you are not using a Mac, you can do almost the same things using the java application [[NairnFEAMPMViz]].


== Downloads ==
== Downloads ==


The application <tt>NairnFEAMPM</tt> is a 64 bit, Intel-only application. Install by expanding the downloaded zip file and dragging <tt>NairnFEAMPM</tt> to your Applications folder. This application require MacOS 10.9 or newer (but is no longer tested below 10.11).
<b>NairnFEAMPM</b> is a "Universal" Mac application (<i>i.e.,</i> runs native on either Intel or new M1 chips). Install by expanding the downloaded zip file and dragging <b>NairnFEAMPM</b> to your Applications folder. This application requires MacOS 10.13 (High Sierra) or newer, but is not tested much below Monterrey (12.x).


{| class="wikitable"
{| class="wikitable"
Line 15: Line 9:
! NairnFEAMPM Download !! Size (MB) !! Updated
! NairnFEAMPM Download !! Size (MB) !! Updated
|-
|-
| width="450"|[http://www.cof.orst.edu/cof/wse/faculty/Nairn/apps/NairnFEAMPM.zip NairnFEAMPM 8.0, with Xerces] - This version is a full-featured version of <tt>NairnFEAMPM</tt> for running [[NairnFEA]] and [[ NairnMPM]] but it does not contain those binaries. To run calculations, you have to [[Download Source Code|check out]] and [[Compiling in MacOS X|compiling the source code]] and with those binaries. See application help on "Code Engine Development" for running in this mode. || align="center" width="65"|3.1 || align="center" width="85"|4 JAN 2021
| width="550"|[http://www.cof.orst.edu/cof/wse/faculty/Nairn/apps/NairnFEAMPM.zip NairnFEAMPM 10.0] - This version is a full-featured version of <b>NairnFEAMPM</b> for running [[NairnFEA]] and [[NairnMPM]] complete with code engine binaries and third party libraries needed for the calculations without needing any additional installations. See below for possible [[#Alternate Binaries Bundles|alternate binaries]].|| align="center" width="65"|8.9 || align="center" width="85"|24 APR 2024
|}
|}


I have given up trying to stay ahead of Apple to keep this package easy to use. Every new MacOS makes it harder and it has now become essentially impossible. Probably the last straw was that it is not possible to provide a parallel version of the software using Apple developer tools. They do not support <tt>OpenMP</tt> methods for parallel code unless every user installs a compiler, like <tt>clang-mp</tt>, that supports it (the compiled code needs its libraries). If you are going to install a compiler, you might as well use it to create your own binaries (the best hack to avoid Apple road blocks). Here are steps to start using NairnFEAMPM to run calculations:
Each new MacOS again tries to stop you running software unless you download it from the Mac App Store. When you first run this app outside that app store, you may get some warnings. Hopefully the only one will about the software being downloaded from the internet. If that is the only one, you should be able to click "OK" and run. You might also get warnings ranging from "the developer is unidentified" to "this might be malicious software." Both are wrong, but if you get them, you can get around these round blocks (for now) by:
<ul>
<li>Control click on the <b>NairnFEAMPM</b> app and choose "Open" from the pop-up menu. You well get the same warning but should now have an "Open" button that will let you ignore that warning.</li>
<li>If first option does not work, open the "General" tab of the "Security &amp; Privacy" pane in the "System Preferences" and then start <b>NairnFEAMPM</b>. The "Security &amp; Privacy" pane should have a button to run the app. Also be sure your Mac is not set to only allow apps from the "App Store".</li>
</ul>
You should only need these Apple work-arounds the first time you run <b>NairnFEAMPM</b>.
 
=== Alternate Binaries Bundles ===
 
The above download has one version of the code engine binaries and required libraries. As code develops, new versions might be available before they are added the downloads.  Or, the binaries might not work in certain MacOS versions. This section gives some options for binary bundles.


<dl>
* '''Swtich to User-Compiled Bounaries''' - to always have the most recent binaries or to be able to edit source code to create your own features, a good option is to install your own binaries., Once <b>NairnFEAMPM</b> is running, choose "NairnFEAMPM Help" from the "Help Menu." You can click on "Installing Binaries" in the help topics on the left. That help information explains how to switch to using your own binaries.
* '''Self-Contained Binary Bundles''' - to following table lists available binary bundles that can easily be download and installed to get alternate boundary binary bundles to run in '''NairnFEAMPM''' (see below the table for installation details).


<dt>Run NairnFEAMPM</dt>
{| class="wikitable"
<dd>Each new MacOS again tries to stop you running software unless you buy it from the Mac App Store where Apple gets 1/3 of of gross sales (I should tell then 1/3 of nothing is still nothing). When you first run the app, you may get some warnings. Hopefully the only one will about the software being downloaded from the it. If that is the only one, you should be able to click "OK" and run. You might also get warnings ranging from "the developer is unidentified" or "this might be malicious software." Both are wrong, but if you get them, you can get around these round blocks (for now) by:
|-
<ul>
! Name !! Description
<li>Control click on the NairnFEAMPM app and choose "Open" from this pop-up menu. You well get the same warning but should now have an "Open" button that will let you ignore that warning.</li>
|-
<li>If first option does not work, open the "General" tab of the "Security &amp; Privacy" pane in the "System Preferences" and then start NairnFEAMPM. The "Security &amp; Privacy" pane should have a button to run the app. Also be sure your Mac is not set to only allow apps from the "App Store".</li>
| align="center" | binaries10-13.tar.gz || width="650"|Although '''NairnFEAMPM''' works in MacOS High Sierra (10.13), the binaries included in the above download not appear to work. This download seems to work in MacOS 10.13 on an Intel-based Mac.
</ul>
|}
You should only need these Apple work-arounds the first time you run NainrFEAMPM.
</dd>


<dt>Install the Required Binaries</dt>
For any binary bundle included in the above table, download and install using the Terminal app and the following two commands
<dd>Once NairnFEAMPM is running, choose "NairnFEAMPM Help" from the "Help Menu." You can read the introduction or just click on "Installing Binaries" in the help topics on the left. That help information explains how to intall all binaries nbeeded to run calculations.</dd>
</dl>


In the future, you can just download updates to NairnFEAMPM and use it without needing to reinstall <tt>Xerces</tt> or recompile the binaries. If the code engines are updated, you can download just the new source code and recompile and they will run in whatever version of NairnFEAMPM you already have. You can even recompile them while running NairnFEAMPM and the next calculations will use the new versions.
<pre>curl -O https://www.geditcom.com/downlds/(Name)
tar fvxz (Name) -C ~/Library/Application\ Support/NairnFEAMPM</pre>


Apple is now switching to new chips. If you are using a new Mac that does not have Intel chips, you will likely need to [[Compiling in MacOS X#Compiling Xerces on MacOS X|install a new <tt>Xerces</tt> binary]] to work on the new chips.
where you replace <tt>(Name)</tt> with the "Name" entry in the table.
The first command downloads a compressed tar file with the binaries (the <tt>-O</tt> is upper case letter O). The second command extracts all files and installs then in the '''NairnFEAMPM''' application support folder (overwriting previous ones if needed). International users might need to change the name of the <tt>Library/Application Support</tt> folders to match their Mac. Once these are installed, '''NairnFEAMPM''' can use them for calculations. Be sure, however, to not "Reinstall Bundle Files" in the preferences because that would overwrite installed alternate binaries.


== Free Registration ==
== Free Registration ==


The <tt>NairnFEAMPM</tt> system is free but uses an unlocking code to help monitor its use. By registering you will hear about developments and/or about any problems that might arise. To get a free registration code, use the "Reguest Registration Code…" command in the "Help" menu. A free code will usually arrive by email within a few days. While waiting you can use the application in "Trial Mode."
The <b>NairnFEAMPM</b> system is free but uses an unlocking code to help monitor its use. By registering you will hear about developments and/or about any problems that might arise. To get a free registration code, use the "Request Registration Code…" command in the "Help" menu. A free code will usually arrive by email within a few days. While waiting you can use the application in "Trial Mode."

Latest revision as of 20:31, 25 April 2024

NairnFEAMPM is a Mac application to run finite element analysis (FEA) and material point method (MPM) calculations. The application contains all binary code engines and third-party libraries required to run calculations without need to build and source code and install any other tools. NairnFEAMPM is being developed by Prof. John A. Nairn from the Wood Science and Engineering Department Oregon State University. This application is free but it is a dynamic work in progress as part of an active research program. If you are not using a Mac, you can do almost the same things using the Windows application NairnFEAMPMViz.

Downloads

NairnFEAMPM is a "Universal" Mac application (i.e., runs native on either Intel or new M1 chips). Install by expanding the downloaded zip file and dragging NairnFEAMPM to your Applications folder. This application requires MacOS 10.13 (High Sierra) or newer, but is not tested much below Monterrey (12.x).

NairnFEAMPM Download Size (MB) Updated
NairnFEAMPM 10.0 - This version is a full-featured version of NairnFEAMPM for running NairnFEA and NairnMPM complete with code engine binaries and third party libraries needed for the calculations without needing any additional installations. See below for possible alternate binaries. 8.9 24 APR 2024

Each new MacOS again tries to stop you running software unless you download it from the Mac App Store. When you first run this app outside that app store, you may get some warnings. Hopefully the only one will about the software being downloaded from the internet. If that is the only one, you should be able to click "OK" and run. You might also get warnings ranging from "the developer is unidentified" to "this might be malicious software." Both are wrong, but if you get them, you can get around these round blocks (for now) by:

  • Control click on the NairnFEAMPM app and choose "Open" from the pop-up menu. You well get the same warning but should now have an "Open" button that will let you ignore that warning.
  • If first option does not work, open the "General" tab of the "Security & Privacy" pane in the "System Preferences" and then start NairnFEAMPM. The "Security & Privacy" pane should have a button to run the app. Also be sure your Mac is not set to only allow apps from the "App Store".

You should only need these Apple work-arounds the first time you run NairnFEAMPM.

Alternate Binaries Bundles

The above download has one version of the code engine binaries and required libraries. As code develops, new versions might be available before they are added the downloads. Or, the binaries might not work in certain MacOS versions. This section gives some options for binary bundles.

  • Swtich to User-Compiled Bounaries - to always have the most recent binaries or to be able to edit source code to create your own features, a good option is to install your own binaries., Once NairnFEAMPM is running, choose "NairnFEAMPM Help" from the "Help Menu." You can click on "Installing Binaries" in the help topics on the left. That help information explains how to switch to using your own binaries.
  • Self-Contained Binary Bundles - to following table lists available binary bundles that can easily be download and installed to get alternate boundary binary bundles to run in NairnFEAMPM (see below the table for installation details).
Name Description
binaries10-13.tar.gz Although NairnFEAMPM works in MacOS High Sierra (10.13), the binaries included in the above download not appear to work. This download seems to work in MacOS 10.13 on an Intel-based Mac.

For any binary bundle included in the above table, download and install using the Terminal app and the following two commands

curl -O https://www.geditcom.com/downlds/(Name)
tar fvxz (Name) -C ~/Library/Application\ Support/NairnFEAMPM

where you replace (Name) with the "Name" entry in the table. The first command downloads a compressed tar file with the binaries (the -O is upper case letter O). The second command extracts all files and installs then in the NairnFEAMPM application support folder (overwriting previous ones if needed). International users might need to change the name of the Library/Application Support folders to match their Mac. Once these are installed, NairnFEAMPM can use them for calculations. Be sure, however, to not "Reinstall Bundle Files" in the preferences because that would overwrite installed alternate binaries.

Free Registration

The NairnFEAMPM system is free but uses an unlocking code to help monitor its use. By registering you will hear about developments and/or about any problems that might arise. To get a free registration code, use the "Request Registration Code…" command in the "Help" menu. A free code will usually arrive by email within a few days. While waiting you can use the application in "Trial Mode."