====== Firedrake notes ======

Notes on installing firedrake via the guide: https://www.firedrakeproject.org/firedrake/install.html

This worked on Homebreak on macOS. Note I operated on my home directory but probably a bad idea compared to operating within a distinct directory.

Download the utility:

<code>
curl -O https://raw.githubusercontent.com/firedrakeproject/firedrake/master/scripts/firedrake-configure
</code>

Using the complex-variable version: 

<code>
python3 firedrake-configure --show-system-packages --arch complex
</code>

Install the homebrew packages: 
<code>
brew install $(python3 firedrake-configure --show-system-packages)
</code>

<code>
git clone --depth 1 --branch $(python3 firedrake-configure --show-petsc-version) https://gitlab.com/petsc/petsc.git
cd petsc
</code>

Run PETSC config
<code>
python3 ../firedrake-configure --show-petsc-configure-options | xargs -L1 ./configure
</code>

Compile PETSC config. Note replace the directory with yours
<code>
make PETSC_DIR=/Users/me/petsc PETSC_ARCH=arch-firedrake-default all
</code>

Check 
<code>
make check
cd ..
</code>

Create virtual environment

<code>
python3 -m venv venv-firedrake
source venv-firedrake/bin/activate
</code>

Export environmental variables: 
<code>
export $(python3 firedrake-configure --show-env)
</code>

Install 
<code>
pip install --no-binary h5py "firedrake @ git+https://github.com/firedrakeproject/firedrake.git#[test]"
</code>

Run the check
<code>
firedrake-check
</code>

===== Exploring Firedrake using jupyter =====

Documentation is taken from here: https://www.firedrakeproject.org/firedrake/notebooks.html

Make sure you're working within the firedrake virtual environment: 
<code>
python3 -m venv venv-firedrake
source venv-firedrake/bin/activate
</code>

Install Jupyter
<code>
python3 -m pip install jupyter
</code>

For some reason, when I did this previously, the import firedrake command did not work in Jupyter. I quit Jupyter, tried 
<code>
python3 -m pip install firedrake
</code>

and this seemed to do the trick, after re-starting the kernel.