Ensure all indices into ABI variables are generated in dependency order, eg
```
idx = indices[iy]
foo = foos[ix]
```

Fix a crash in GPU code when threshold detector is used for the first time and its internal state is allocated with a wrong size.

- Add a callback to be executed between epochs.
- Add example: print progress indicator

TL;DR: Simple change for ~2% gain on GPU in a typical workload.

* add support for parsing markers defined in asc files
* add hitherto unknown "High" leaf branch type

Since we have support for ACC loading, the errors thrown by `paint` are no longer
sufficiently informative. Even before that it was already hard to correlate source 
and locus of painting errors.

Example
```
$> python3 main.C51A.py
Traceback (most recent call last):
  File "main.C51A.py", line 33, in <module>
    cell = A.cable_cell(morph, labels, decor)
RuntimeError: cable_cell: cable (cable 6 0 1) overpaints
```
This adds more details to the error message
```
$> python3 main.C51A.py
Traceback (most recent call last):
  File "main.C51A.py", line 33, in <module>
    cell = A.cable_cell(morph, labels, decor)
RuntimeError: cable_cell: Setting property 'ion-reversal-potential' on region '(region "soma_group")' overpaints at '(cable 6 0 1)'
```

* Make brunel.py setup faster.
* Use one generator for both populations.

filter out death test on daint single_node_release

Exports all symbols so arbor can be compiled as set of shared libraries. 

In order to export all symbols correctly, one macro per library and one global macro are added. The content of the macros is determined at configure time depending on build variant (static/shared), compiler, and platforms (linux, mac os) and goes into the library's include directory as `export.hpp` when installed (at build time it resides at cmake's temporary build directory). The per-library macro is named `ARB_LIBNAME_API` and goes in front of to-be-exported symbols. The global macro is `ARB_SYMBOL_VISIBLE`. 

This PR adds the annotation in all of the places where it is required. Most of them are in the public headers (and corresponding sources) but some are also added in internal headers, which were required for the unit tests to link properly.

Fixes #1752

Half-half dev and user docs on NMODL optimisation. Actually apply that advice in hh.mod

PyArbor I/O routines now try to cast `filename` arguments to a string.
This allows passing `pathlib.Path` objects.

Example
```py
here = Path(__file__).parent
cat = A.load_catalogue(here / 'local-catalogue.so')
```

* Some badges corrected (build) and added (Gitter)
* Minor Spack backports
* Small updates to `release.rst`

Closes #1822. Adds a separate tutorial for extracellular signal predictions using LFPykit to the docs. Adds some minor improvements to the corresponding python example file. Introduces Intersphinx for linking to other documentation.

* Users may not give dt < 0 to simulation.run()
* Add and throw domain_error.

* Update VERSION to `v0.6.1-dev`
* Updates to `doc/release.rst`
* Update Zenodo citation info for v0.6
* Update copyright info and maintainers in `spack/package.py` from upstream
* Fix error in build-badge docs

* bump version to v0.6-rc
* Update `MANIFEST.in` and `scripts/run_python_examples.sh`
* Update Release instructions `docs/contrib/release.rst`
* Fix missing quotes in `python/example/single_cell_nml.py`
* Add testing to sdist creation in `ciwheel.yml`
* Rename `basic.yml` to `test-everything.yml`
   * Remove Python examples step from matrix (mostly because plotting takes much CPU on macos)
   * change to build /w nml
   * add test of pip builds (`pip install` in addition to CMake builds)
      * Python examples are tested here, once is enough.

# Changes

- `cable_cell_global_properties` now holds a catalogue directy
- fixes for tests, examples, and python bindings accordingly

# Linked Issues
Fixes #1446 

- build-catalogue
  - now installed by pip
  - enable GPU-backends
  - isolate from being installed in a non-default dir
  - rename to arbor-build-catalogue
  - allow hand-written C++ mechanisms to be linked in the same catalogue.
- CMake
  - enable PIC on arbor always to allow linking to shared objects
  - use relative paths when configuring a-b-c, to make relocation less of a problem
- Python
    - ensure a-b-c is installed by pip, along with headers and libarbor.a
    - throw errors if tools (cmake scripts, arbor package, modcc) missing
    - transition setup.py setuptools -> skbuild.
- Wheels
    - Add NML2 support to wheels
    - scripts/build-wheels.sh builds wheels, in principle valid for submission to PyPI, on your own hardware. This should be kept in sync with .github/workflows/ciwheel.yml
    - scripts/patchwheel.py corrects the rpath in the libraries in the wheels, working around a bad interplay between auditwheel and skbuild, see pypa/auditwheel#363
    - Python Wheels are tested as part of the Github Action 
    - Add nml and bundled status to config().

* Pyarb specific.
* `proc_allocation_shim()` throws error if user sets threads to zero.
* `arbor.context` constructor accepts `threads` set to `"avail_threads"`, which sets the number of threads to `arbenv::thread_concurrency()`
  * This introduces a dependency on arbenv for Pyarb.
* Docs and tests added.

Fixes #1692 

Add a modified version of the benchmark cell example that uses dry run scaling.

- Add support for profiling externally loaded mechanisms.
- Move the profiler calls out of the generated C++ code into the `arb::mechanism` methods. 
- Remove the `--profile` flag from the modcc flags. 
- Replace `_` delimiter with `:` in profiler. 
- Replace `const char*` with `const std::string&` for profiler region representation.
- Profiler may now contain empty regions that were registered but not profiled, so add some code to filer those out when generating final profile.

- Bump CMake to 3.18 for better CUDA support.
- Clean-up our use of said support.
- Remove old cruft and workarounds.
- Maintenance in CI: enable MacOS 11; bump CMake versions to 3.18 / 3.22; bump bors CMake to 3.18

Fixes #1790 

- Implement a new constructor for `domain_decomposition` from a vector of `group_descriptions`. The new constructor performs various checks on the given `group_descriptions` and throws an appropriate exception if any problem is found. It is the only available constructor for `domain_decomposition`.
- Make the various members of `domain_decomposition` private and implement their getters.  
- Expose the `domain_decomposition` constructor to the python interface through a `partition_by_group` function.
- Add unit tests. 
- Add documentation.