BEARCLAW
Steps
- Ensure that you have at least 36GB free space on your host machine. A convenient option is to install the environment on a high-speed USB 3.0 (or higher) SSD drive (not a USB Flash drive) with 64GB or higher capacity.
- Remove any previous version of VirtualBox from your machine.
- Install VirtualBox (version 6.1) on your host machine. The BEARCLAW virtual machine assumes the host machine satisfies the CCI minimal requirements. Also install the VirtualBox Extension Pack.
- Create a BEARCLAW directory somewhere on your machine, and download into this directory the file BEARCLAW.ova (8.4 GB). This is an Open Virtual Appliance file that contains the preconfigured BEARCLAW environment. This is a large file and should be downloaded from high-speed connections.
- From File Explorer (under Windows) or Finder (under OS X) right-click and open the downloaded BEARCLAW.ova file. This will decompress the virtual machine image onto your host computer.
- In VirtualBox, adjust the settings of the BEARCLAW virtual machine. In particular:
- Set virtual machine memory to 25-50% of your host machine memory;
- Define shared folders so you can access your host machine files in your virtual machine;
- Adjust the scale factor to 200% if you have a high-definition display
- From VirtualBox, launch the BEARCLAW virtual machine. If your machine is not configured to allow 64-bit virtualization, see remedy below.
- Log onto BEARCLAW:
- Username: student
- Password: tarheel
- After the initial virtual machine boot and login you can suspend the BEARCLAW environment whenever needed through the File->Close->”Save the machine state” menu option. This allows you to save your current work, and return to the exact same state upon restart.
- Explore code capabilities through the showcase!
Enabling 64-bit virtualization
If your machine is not configured to allow 64bit virtualization, change UEFI or BIOS settings.
- On older machines, this is accessed by pressing F1, F2, F10, F12 or Del keys immediately upon poweron.
- On newer machines running Windows 10, go to Settings->Windows Update->Recovery->Troubleshoot->Advanced options->UEFI firmware->Restart. This will boot up the machine into UEFI Firmware setting.
Once in the settings, choose Security and enable both virtualization options.
Software highlights
- BEARCLAW, a general purpose package to solve partial differential equations, successor of CLAWPACK to solve of hyperbolic, parabolic and elliptic equations using adaptive mesh refinement, and allowing various levels of parallelism (OpenMP, MPI, CUDA).
- TeXmacs, a sophisticated editor allowing embedded computational sessions, natural mathematical notation, export to LaTeX, PDF, HTML formats. The virtual machine environment has preconfigured support for sessions in: Asymptote, Clisp, Eukleides, Gnuplot, Maxima, Octave, Python, Scheme, Mathematica. Inclusion of such sessions allows production of “live” documents that combine mathematical text, graphics, and computation, enabling both instruction and reproducible research. Of crucial practical importance to research in scientific computation, TeXmacs is extensible through Guile (an implementation of Scheme, which is itself a descendent of LISP). Use of Guile extensions allows sophisticated processing and concurrent documentation. In particular, BEARCLAW itself and its application suite are documented in TeXmacs.
- Complete, up-to-date Gnu compiler suite (v9.2, gcc, g++, gfortran, gccgo)
- Python3 environment for scientific computing
- TensorFlow, a machine learning platform within Intel Python (CPU only)
- Pyzo, a Python IDE configured to work with Intel Python
- Octave, a free Matlab clone
- Maxima, a symbolic computation system
- Julia, a high-performance scripting language for scientific computation
- SageMath, a unified Python interface to a suite of open-source applications covering many areas of mathematics
- JupyterLab, a notebook interface to Julia, Octave, Python, SageMath
- FreeFEM++, a high-level finite element language
- Calculix structural finite element package
- FreeCAD 3D parametric modeler, capable of interaction with Calculix
- TeXlive typesetting system
- Paraview, OpenDX data visualization
- OpenMPI, parallel computation through message passing
- Lazarus, a cross-platform rapid application development environment that uses Free Pascal
- Inkscape, Gimp drawing applications
- Libreoffice, a complete office software suite with support for Microsoft formats
- Genius, an advanced general-purpose calculator especially well-suited for educational demos
Tutorials
Several tutorials are posted on the BEARCLAW website