Skip to content

Latest commit

 

History

History
137 lines (92 loc) · 9.18 KB

README.md

File metadata and controls

137 lines (92 loc) · 9.18 KB
Raw

Svalinn plugins and command extensions for Cubit

The plugin has been tested and is confirmed to work with versions of Coreform Cubit up to 2021.5 and versions of Cubit up to 15.8.

Trelis 17.01 Cubit 2021.4 Cubit 2021.5 Cubit 2021.11
Ubuntu 18.04 version
Ubuntu 20.04 version version version
Ubuntu 21.04 version version version
Debian 10.10 version version
Mac OS version version version version
Windows version version version version

Install Cubit

Cubit or Corefoam Cubit can be installed by following the instructions on the relevant website. Cubit is available for Sandia and US National labs users while Coreform Cubit is available via comerical licenses or freeley available for students and hobbyists as Cubit Learn.

Expand - Ubuntu terminal commands for Corefoam Cubit 

    sudo apt update
    sudo apt-get install wget
    wget -O coreform-cubit-2021.5.deb https://f002.backblazeb2.com/file/cubit-downloads/Coreform-Cubit/Releases/Linux/Coreform-Cubit-2021.5%2B15962_5043ef39-Lin64.deb
    sudo dpkg -i coreform-cubit-2021.5.deb

Installation with Coreform Cubit (as of version 2023.8)

The DAGMC plugin is now shipped with Coreform Cubit starting at version 2023.8, but it is not activated by default. Following the instructions corresponding to your operating system to enable the plugin.

On Windows and Linux, use the dropdown menu "Tools", then select "Plugins...". Add the bin/plugins directory via the diaglog box. Restart Cubit to activate the plugin.

On Mac, use the dropdown menu "Tools", then select plugins and select "Add". Next, in Finder, navigate to /Applications/Coreform-Cubit-2023.8.app/Contents/lib/plugins. Drag the plugins folder from the finder and drop it in the Cubit window. Once you restart Cubit, the plugin will be activated. You can confirm this by typing "help dagmc" in the command line.

Manually Install The Plugin

The Plugin can be downloaded from the Release section of this repository. Operating system specific assets are created with each release and can be download for various Operating systems (Ubuntu 18, 20 and MacOS 10.15).

After downloading the compressed tgz file the contents should be uncompress to your Cubit folder.

Expand - Terminal commands for Ubuntu 20.04 

    wget https://github.com/svalinn/Cubit-plugin/releases/download/0.1.0/svalinn-plugin_ubuntu-20.04_cubit_2021.5.tgz
    sudo tar -xzvf svalinn-plugin_ubuntu-20.04_cubit_2021.5.tgz -C /opt/Coreform-Cubit-2021.5

Test the Plugin

Load Cubit by running coreform_cubit from the command line. After the Cubit GUI finishes loading, run the following command in the Cubit command line:

help dagmc

If the plugin was installed correctly you should see the following text appear.

Help for words: dagmc.

export dagmc <filename> [faceting_tolerance <faceting tolerance>] [length_tolerance <length tolerance>]
     [normal_tolerance <normal tolerance>] [make_watertight] [verbose]
     [fatal_on_curves]

If this output does not appear, then the plugin was not installed correctly.

Usage within Cubit

The DAGMC plugin commands should now be accessable via the Cubit command line.

To view the available command line options for the MCNP importer, type help mcnp in the Cubit command line.

Similarly for the DAGMC exporter, type help dagmc in the Cubit command line.

Some sample files have been included in the test_plugin directory of this repository for testing the command line usage.

Building the plugin

Building the plugin from source is also possible but only recommended for developers.

Updating the repository for new Cubit releases

Add the Cubit new version number to the following three lists:

Create a new elif entry in the Environment Variables stage of the yml files. Set the BASE variable equal to the full URL (with the hash) of the new Cubit release.

Add an entry for the new Cubit version in the scripts/unix_share_build.sh file

Add new links in the table at the top of the README.md to contain a link to the new plugin files (tgz or zip files). These files won't exist at this stage but the links can be anticipated in advance (see existing links for the URL pattern).

Create a pull request to the develop branch with these changes to the .github/workflows CI yml files and README.md

Wait for the CI to run tests on the new code and the pull requested to be approved

Once the pull request is merged into develop then create a release from the develop branch, this will launch more CI that builds the plugins for various systems and versions. The links added to the README.md should now allow the newly build plugin to be downloaded.