OSParticulas

OSParticulas and NairnMPM are both MPM code engines. The difference is that OSParticulas is for new features in development, for proprietary or unpublished features, and for features not yet released to the open source version.

New OSParticulas Features

Some of the features in development and/or only available in OSParticulas. Some of these features are documented here (as listed as OSParticulas only), some are not yet documented, and others are just code improvements that don't need documentation. The unique features of OSParticulas include:

• MPM modeling with large-deformation membranes in both 2D and 3D simulations.
• A new feature to allow materials to ignore cracks, which means the material can be "inside" the crack. Such materials interact with the fields above and below the crack by contact mechanics. The typical use is to wedge up a cracks or drive a nail or screw along crack plane.
• A new feature to recognize presence of cracks and interfaces during heat conduction calculations.
• Softening materials to implement anisotropic damage mechanics or several material types.
• Phase transition materials to simulate transitions between two materials.
• Tracking of particle spin, which can improve results in problems with rotation, especially for PIC (note: this feature is only enabled if OSParticulas is compiled with the ADD_PARTICLE_SPIN option defined in MPMPrefix.hpp).
• Ability to set position-dependent spin momentum on particles.
• 3D Cracks
• Option to run in "transport-only" mode for conduction and diffusion calculations
• Modeling of rigid blocks
• Various other features currently in development

Using OSParticulas

OSParticulas is available to members of the OSU MPM Consortium and selected collaborators with the research group of Prof. John A. Nairn at Oregonstate University. For details, you can contact us with an email. Once you are set up as a collaborator, you can check out OSParticulas using

svn checkout http://(server)/svn/OSParticulas/trunk mycheckout --username myusername

where (server) is the name for the computer currently storing the OSParticulas repository, mycheckout is any name you pick to be used for checked out folder, and myusername is your user name. After this command you enter your password and the files will be checked out. The server name, user name, and password will be provided when your account to check out OSParticulas is set up.

You can check out tagged or branched versions, a prior revision number, or the version on a specific date using the following checkout commands:

svn checkout http://(server)/svn/OSParticulas/tags/release-1.0 OSParticulas-1.0 --username myusername
svn checkout http://(server)/svn/OSParticulas/branches/MyBranch OSParticulas-MyBranch --username myusername
svn checkout --revision 185 http://(server)/svn/OSParticulas/trunk rev-185 --username myusername
svn checkout --revision {2014-07-04} http://(server)/svn/OSParticulas/trunk dated-2014-07-04 --username myusername

where you insert tag name, revision number or date as desired. The text before --username is the name of the folder when checkout on your computer and can be any text that helps you recognize the contents of the checkout.

Installing svn in MacOS

Starting with Big Sur, Apple decided to delete subversion from their command line tools. Because OSParticulas still uses subversion, you will need to install it. The install can be done using MacPorts or HomeBrew. To install using MacPorts:

1. If not already installed, install MacPorts. Be aware that it might need to be reinstalled after updating your MacOS.
2. Open the Terminal app and enter

   sudo port install subversion

If you prefer to use HomeBrew, subversion can be installed with:

1. If not already installed, install HomeBrew in Terminal app using:

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

   Be sure to do recommended two commands at the end.
2. Open the Terminal app and enter

   brew install svn

To verify if the method you used work, open Terminal app and enter

which svn

You should get

/opt/local/bin/svn
/opt/homebrew/bin/svn

where first if after using MacPorts and second is after using HomeBrew.

OSParticulas Documentation

This wiki site documents both OSParticulas and NairnMPM; features that are only available in OSParticiulas will be noted. Those enabled to use OSParticulas can check the documentation notes in their download for any additional setup steps and for instructions on using any extra features available in OSParticulas that are not yet written up in these wiki pages.