Difference between revisions of "NairnFEAMPM"

From OSUPDOCS
Jump to navigation Jump to search
 
(165 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 ==


Starting with <tt>NairnFEAMPM 5.1</tt>, this application is 64 bit, Intel-only and requires MacOS 10.6 or newer (see [[#Legacy Downloads|legacy downloads]] if this version does not work for your). Install by mounting the downloaded disk image and dragging <tt>NairnFEAMPM</tt> to your Applications folder. After starting the application, please read the help information (in the "Help" menu) menu to get started, including some quick start, sample calculations.
<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"
|-
|-
! NairnFEAMPM Download !! Size (MB) !! Updated
! NairnFEAMPM Download !! Size (MB) !! Updated
|-
| width="450"|[http://people.oregonstate.edu/~nairnj/FEAMPM/startup/NairnFEAMPM.dmg NairnFEAMPM 5.1 Full Featured Version] - This 64 bit application is the full-featured version of <tt>NairnFEAMPM</tt> and it contains compiled binaries for finite element analysis (NairnFEA 4.0.0) and for material point method analysis (NairnMPM 10.0.0) along with the xerces library (version 3.1.1) that is used to process <tt>XML</tt> data. || align="center" width="65"|4.8 || align="center" width="85"|10 FEB 2013
|-
|-
| [https://itunes.apple.com/app/nairnfeampm/id496317896?mt=12 NairnFEAMPM 5.0 App Store Version] - <tt>NairnFEAMPM</tt> is also available on the Mac App Store, but it as a slightly different version. The current version in the store is 5.0, and it  follows Apple's strict new security rules called sandboxing. See below for what this style means and therefore to determine which version you need. || align="center"|- || align="center"|25 JAN 2012
| 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
|}
|}


To see "what's new" (for previous users), contact information, disclaimers, and more, open the help window using the "Help" menu in the downloaded application. If for some reason, you cannot get the binaries to run on your computer, you can convert to using external binaries by following the "Code Engine Development" help topic. Using external boundaries also allows you to keep up to date with lastest code engines without needing to wait for <tt>NairnFEAMPM</tt> application updates.
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>
=== App Store Version ===
<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>
The App Store version is ready to run and can do both FEA and MPM calculations, but it is sandboxed application. While sandboxing may be a benefit to users for security, it is not fully compatible with some uses of <tt>NairnFEAMPM</tt> that think of your computer as your workstation for research rather than as a sandbox for play time. The main differences needed for sandboxing are listed below; if you need any of these missing features, simply switch to the full-feature version instead. If not, the sandboxed version should be fine.
</ul>
 
You should only need these Apple work-arounds the first time you run <b>NairnFEAMPM</b>.
<dl>
<dt><b>Workspace Folder</b>
<dd>The App Store version cannot read or write any of your own files unless you grant it specific permission. The solution is for you to designate a workspace folder with that permission. You will be asked to pick a workspace folder the first time <tt>NairnFEAMPM</tt> is launched. You can change this selection at any time in the preferences window. All calculations should be saved in this folder only.</dd>
 
<dt><b>External Code Engines</b>
<dd>A powerful way to use <tt>NairnFEAMPM</tt> is for code engine development, but running executable binaries in arbitrary locations is a challenge for a sandboxed application. The solution was to eliminate this option for the App Store version. If you want to run external code engines, you need to use the full-featured version.</dd>


<dt><b>Background Processes</b>
=== Alternate Binaries Bundles ===
<dd>The full-featured version lets you submit long calculations to background process that will run even if you quit <tt>NairnFEAMPM</tt>. Creating such independent processes within a sandboxed application does not appear possible. If you want to be allowed to submit background jobs, you need to use the full-featured version. In addition the process info window is only needed for monitoring background jobs and therefore it is only available in the full-featured version.</dd>


<dt><b>Scripting</b>
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.
<dd>Although <tt>NairnFEAMPM</tt> is a scriptable application, it is a challenge to support robust scripting options in a sandboxed application (and python, which I prefer, seems to not be allowed). As a result, the scripts menu is only available in the full-featured version. If you would like to use scripts to control calculations, you should switch to the full-featured version.</dd>


</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).
=== Legacy Downloads ===
 
If you do not have MacOS 10.6 or newer and a Mac with 64 bit Intel chips, the above version will not work for you. The downloads below are some legacy versions that might work. The legacy downloads have no binaries and will not do any calculations. But they can be set up to run the latest calculations by downloading and compiling the code engine source code available in the [[Download Project|<tt>nairn-mpm-fea</tt> project] as external binaries. For details, see the "Code Engine Development" help in the <tt>NairnFEAMPM</tt> application. You will have latest code engines, but will be missing the latest features in <tt>NairnFEAMPM</tt>. You can still run most things, but might have to resort to using XML commands for features in the binaries that were developed after these versions were released.


{| class="wikitable"
{| class="wikitable"
|-
|-
! NairnFEAMPM Legacy  Download !! Size (MB) !! Updated
! Name !! Description
|-  
|-  
| width="450"|[http://people.oregonstate.edu/~nairnj/FEAMPM/startup/NairnFEAMPM4.dmg NairnFEAMPM 4.0 - no binaries] - This version should be used only if your Mac has MacOS Leopard (10.5) with Intel chips. || align="center" width="65"|3.1 || align="center" width="85"|19 JAN 2012
| 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.
|-
| [http://people.oregonstate.edu/~nairnj/FEAMPM/startup/NairnFEAMPM3.dmg NairnFEAMPM 3.0 - no binaries] - This version should be used only if your Mac has MacOS Tiger (10.4) and/or has a Power PC processor. || align="center" |2.8 || align="center" |9 DEC 2010
|}
|}


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


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."
<pre>curl -O https://www.geditcom.com/downlds/(Name)
tar fvxz (Name) -C ~/Library/Application\ Support/NairnFEAMPM</pre>


== Acknowledgments ==
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.


<tt>NairnFEAMPM</tt> is being developed as part of the author's research program. This program have been supported
== Free Registration ==
by various organizations. Some specific acknowledgments go to:


<ul>
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."
<li><b>Department of Agriculture (USDA)</b></li>
<li><b>Department of Energy (DOE)</b>
<ul>
<li>Nanotechnology Grant Subcontract 2103050</li>
<li>Center for the Simulation of Accidental Fires and Explosions (C-SAFE), Lawrence
              Livermore National Laboratory, under Subcontract B341493</li>
</ul>
</li>
 
<li><b>National Science Foundation (NSF)</b>
<ul>
<li>Mechanics of Materials program: CMS-9713356</li>
<li>Mechanics of Materials program: CMS-940177</li>
</ul>
</li>
 
</ul>

Latest revision as of 19: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."