anabel

An end to end differentiable finite element framework.

Foundations

Installation

The base Anabel package can be installed from a terminal with the following command:

$ pip install anabel

This installation includes basic tools for composing "neural network" -like models along with some convenient IO utilities. However, both automatic differentiation and JIT capabilities require Google's Jaxlib module which is currently in early development and only packaged for Ubuntu systems. On Windows systems this can be easily overcome by downloading the Ubuntu terminal emulator from Microsoft's app store and enabling the Windows Subsystem for Linux (WSL). The following extended command will install Anabel along with all necessary dependencies for automatic differentiation and JIT compilation:

$ pip install anabel[jax]

The in-development version can be installed the following command:

$ pip install https://github.com/claudioperez/anabel/archive/master.zip

Core API - Modeling PDEs

from anabel import template, diff, MappedMesh
from anabel.interpolate import lagrange_t6

@template(6)
def poisson_template(u,v,iso,f,):
    def poisson(uh,xyz):
        return diff.jacx(u)(u,v)

Utility Modules

anabel.sections

from anabel.sections import Tee

t_section = Tee(bf=60, tf=6, tw=18, d=24)
t_section.plot()

anabel.transient

Building The Documentation

The following additional dependencies are required to build the project documentation:

• Pandoc
• Elstir (pip install elstir)

To build the documentation, run the following command from the project root directory:

$ elstir build

Organization of Source Code

Documentation

• elstir.yml
• style/ Directory holding style/template/theme files for documentation.
• docs/api/ Automatically generated API documentation files.

Source Code

• setup.py Installation/setup; used for pip installation.
• src/anabel/ Python source code
• [lib/] C++ source code for extension library

Data

• dat/quadrature/ Quadrature scheme data.

Source Control, Testing, Continuous Integration

• .gitignore Configuration for Git source control.
• .appveyor.yml configuration file for Appveyor
• .coveragerc configuration file for CodeCov, used to measure testing coverage.
• pytest.ini configuration file for PyTest, used to setup testing.

Changelog

0.1.0 (2021-05-21)

• First documented release

0.0.0 (2020-07-15)

• First release on PyPI.