Difference between revisions of "NairnFEAMPM"

From OSUPDOCS
Jump to navigation Jump to search
(24 intermediate revisions by the same user not shown)
Line 9: Line 9:
== 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).
The application <tt>NairnFEAMPM</tt> "Universal" Mac app (<i>i.e.,</i> runs native on either Intel or new M1 chips). Install by expanding the downloaded zip file and dragging <tt>NairnFEAMPM</tt> to your Applications folder. This application requires MacOS 10.9 or newer (but is no longer tested below 10.14).


{| class="wikitable"
{| class="wikitable"
Line 15: Line 15:
! NairnFEAMPM Download !! Size (MB) !! Updated
! NairnFEAMPM Download !! Size (MB) !! Updated
|-
|-
| width="450"|[http://www.geditcom.com/downlds/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="450"|[http://www.cof.orst.edu/cof/wse/faculty/Nairn/apps/NairnFEAMPM.zip NairnFEAMPM 9.3] - This version is a full-featured version of <tt>NairnFEAMPM</tt> for running [[NairnFEA]] and [[ NairnMPM]] but it does not contain the binary code engines binaries needed for the calculations and does not contain the xerces library. To run calculations using <tt>NairnFEAMPM</tt>, you have to [[Download Source Code|check out]] and [[Compiling in MacOS X|compile the source code]] for those those binaries and install xerces. See application help on "Code Engine Development" for running in this mode. || align="center" width="65"|3.9 || align="center" width="85"|6 OCT 2022
|}
|}


Here is a test link to another location: [http://www.cof.orst.edu/cof/wse/faculty/Nairn/apps/NairnFEAMPM.zip NairnFEAMPM 8.0, with Xerces]
I have given up trying to stay ahead of Apple to keep this package easy to use with bundled binaries. 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 and the resulting binaries need the <tt>clang-mp</tt> 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:
 
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 (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). Below are steps to run NairnFEAMPM. Many of these only need to be done once.


<dl>
<dl>
<dt>Install Xerces</dt>
<dd>The code engines use the public-domain <tt>Xerces</tt> package for robust reading of <tt>XML</tt> files. The binary is included in the above download and Apple used all binaries to link to that executable, but that no longer seems possible. To install it:
<ol>
<li>Control click on NairnFEAMPM app and choose "Show Package Contents"</li>
<li>Navigate to folder <tt>Contents/Resources/binaries/lib</tt></li>
<li>Open a new Finder window, choose menu command "Go to Folder...", enter "/usr". You will need to provide your password to open this folders (Apple does not think are are smart enough to see it).</li>
<li>In <tt>/usr</tt> folder, navigate to folder <tt>/usr/local/lib</tt> (you may need to create the "local" or "lib" folders if not already there).</li>
<li>Drag the two <tt>Xerces</tt> files from the <tt>Contents/Resources/binaries/lib</tt> folder in NairnFEAMPM app to the <tt>/usr/local/lib</tt> folder.</li>
</ol>
<dd>
<dt>Compile NairnFEA and NairnMPM Binaries</dt>
<dd>[[Download Source Code|Check out]] and [[Compiling in MacOS X|compiling the binaries]] as explained in those links.</dd>


<dt>Run NairnFEAMPM</dt>
<dt>Run NairnFEAMPM</dt>
<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 will get messages like "the developer is unidentified" or "this might be malicious software." Both are wrong. I pay Apple every year to be an identified developed and I code-signed the app, but Apple puts not effort into "identifying" developers. The "malicious" warning is because I have not implemented a new Apple requirement to upload the app to Apple for notarization. You can get around these round blocks (for now) by:
<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 gross sales (I should tell then 1/3 of nothing is nothing). When you first run the app, 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>
<ul>
<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>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.</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>
<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>
</ul>
</ul>
You should only need these Apple work-arounds the first time you run NainrFEAMPM.
You should only need these Apple work-arounds the first time you run NairnFEAMPM.
</dd>
</dd>


<dt>Link to Compiled Binaries</dt>
<dt>Install the Required Binaries</dt>
<dd>Open help window for NairnFEAMPM and see the help section on "Code Engine Development". It explains how to set the preferences to run the binaries you created above.</dd>
<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 install all binaries needed to run calculations.</dd>
</dl>
</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.
In the future, you can just download updates to NairnFEAMPM and use it without needing to reinstall 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.
 
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.


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

Revision as of 16:55, 6 October 2022

NairnFEAMPM is a Mac-only application to create simulations, run them, and visualize them.

Introduction

The NairnFEAMPM application is finite element and material point method analysis software for the Macintosh. 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 java application NairnFEAMPMViz.

Downloads

The application NairnFEAMPM "Universal" Mac app (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.9 or newer (but is no longer tested below 10.14).

NairnFEAMPM Download Size (MB) Updated
NairnFEAMPM 9.3 - This version is a full-featured version of NairnFEAMPM for running NairnFEA and NairnMPM but it does not contain the binary code engines binaries needed for the calculations and does not contain the xerces library. To run calculations using NairnFEAMPM, you have to check out and compile the source code for those those binaries and install xerces. See application help on "Code Engine Development" for running in this mode. 3.9 6 OCT 2022

I have given up trying to stay ahead of Apple to keep this package easy to use with bundled binaries. 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 OpenMP methods for parallel code unless every user installs a compiler, like clang-mp, that supports it and the resulting binaries need the clang-mp 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:

Run NairnFEAMPM
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 gross sales (I should tell then 1/3 of nothing is nothing). When you first run the app, 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.

Install the Required Binaries
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 install all binaries needed to run calculations.

In the future, you can just download updates to NairnFEAMPM and use it without needing to reinstall 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.

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 "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."