Demo mesh files and git-lfs
===========================

Demo mesh files are handled using git-lfs.

You can download the actual files with
  git-lfs fetch -X *xdmf
  git-lfs checkout
If you don't have access to the copies in the Debian repo
(e.g. a clone of a clone) then you can extract them directly
from upstream with
  git-lfs fetch -X *xdmf https://bitbucket.org/fenics-project/dolfin.git
  git-lfs checkout

demo/undocumented/elasticity/pulley.xdmf is ascii not binary, so is
provided by debian patch git-lfs_fetch_demo_meshes. To get smooth
application of the patch, you might want to run
  rm demo/undocumented/elasticity/pulley.xdmf  # not git rm!
  git checkout demo/undocumented/elasticity/pulley.xdmf 



test_exodus.exo
===============

The binary file scripts/dolfin-convert/test_exodus.exo is a sample
mesh file in the Exodus II file format, see
https://gsjaardema.github.io/seacas/html/index.html

The Exodus format uses NetCDF as the data format inside the file.

The mesh (a simple 2D square) may be viewed using paraview.


Python demo docs
================

Python docs for demos are generated using jupytext from the python
demo scripts.  Debian has not yet packaged jupytext (see Bug) so the
source doc files (.md) have been generated manually by locally
installing jupytext and running
  PYTHONPATH=${SRCDIR}/debian/tmp-real/usr/lib/python3/dist-packages \
    PKG_CONFIG_PATH=`pwd`/build/pkgconfig:${PKG_CONFIG_PATH} \
    LD_LIBRARY_PATH=${SRCDIR}/debian/tmp-real/usr/lib/x86_64-linux-gnu/:${LD_LIBRARY_PATH} \
    RDMAV_FORK_SAFE=1 \
  python3 jupytext_process.py
is the python/doc/source subdir. i.e. using the same environment variables that
are used when building the docs with `make html`

The resulting demos subdir, containing *.md doc files, has then been
copied to debian/doc.  A symlink is created with building docs to
access these demo source files.
