dapper 1.6.0__tar.gz → 1.7.1__tar.gz

{dapper-1.6.0 → dapper-1.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: dapper
-Version: 1.6.0
+Version: 1.7.1
 Summary: DAPPER benchmarks the performance of data assimilation (DA) methods.
 Author: Patrick N. Raanes
 Author-email: patrick.n.raanes@gmail.com
@@ -17,21 +17,22 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENCE.txt
-Requires-Dist: scipy>=1.10
-Requires-Dist: jupyter
+Requires-Dist: scipy>=1.14
+Requires-Dist: numpy~=2.0
+Requires-Dist: matplotlib>=3.10
+Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: ipython>=7.34
 Requires-Dist: ipdb
-Requires-Dist: ipython>=5.1
-Requires-Dist: tornado~=6.3.2
-Requires-Dist: matplotlib~=3.7
-Requires-Dist: mpl-tools==0.2.50
-Requires-Dist: tqdm~=4.31
-Requires-Dist: pyyaml
+Requires-Dist: jupyter
+Requires-Dist: notebook<7
+Requires-Dist: mpl-tools==0.4.1
+Requires-Dist: tqdm~=4.67
 Requires-Dist: colorama~=0.4.1
 Requires-Dist: tabulate~=0.8.3
-Requires-Dist: dill==0.3.2
-Requires-Dist: patlib==0.3.5
+Requires-Dist: pathos~=0.3
+Requires-Dist: dill==0.3.8
+Requires-Dist: patlib==0.3.7
 Requires-Dist: struct-tools==0.2.5
-Requires-Dist: multiprocessing-on-dill==3.5.0a4
 Requires-Dist: threadpoolctl<4.0.0,>=3.0.0
 Provides-Extra: qt
 Requires-Dist: PyQt5; extra == "qt"
@@ -39,7 +40,6 @@ Requires-Dist: qtpy; extra == "qt"
 Provides-Extra: debug
 Requires-Dist: line_profiler; extra == "debug"
 Requires-Dist: pre-commit; extra == "debug"
-Requires-Dist: pdbpp>=0.10.3; extra == "debug"
 Provides-Extra: test
 Requires-Dist: tox; extra == "test"
 Requires-Dist: coverage>=5.1; extra == "test"
@@ -51,17 +51,23 @@ Requires-Dist: pytest-clarity; extra == "test"
 Requires-Dist: pytest-xdist; extra == "test"
 Requires-Dist: pytest-timeout; extra == "test"
 Provides-Extra: lint
-Requires-Dist: flake8<5; extra == "lint"
-Requires-Dist: flakeheaven; extra == "lint"
-Requires-Dist: autopep8; extra == "lint"
+Requires-Dist: ruff; extra == "lint"
+Provides-Extra: doc
+Requires-Dist: mkdocs-material; extra == "doc"
+Requires-Dist: mkdocstrings; extra == "doc"
+Requires-Dist: mkdocstrings-python; extra == "doc"
+Requires-Dist: mkdocs-gen-files; extra == "doc"
+Requires-Dist: mkdocs-literate-nav; extra == "doc"
+Requires-Dist: mkdocs-section-index; extra == "doc"
+Requires-Dist: mkdocs-glightbox; extra == "doc"
+Requires-Dist: mkdocs-jupyter; extra == "doc"
+Requires-Dist: pybtex; extra == "doc"
 Provides-Extra: build
 Requires-Dist: twine; extra == "build"
-Requires-Dist: pdoc; extra == "build"
-Requires-Dist: jupytext; extra == "build"
+Requires-Dist: jupytext<=1.15; extra == "build"
 Provides-Extra: dev
 Requires-Dist: line_profiler; extra == "dev"
 Requires-Dist: pre-commit; extra == "dev"
-Requires-Dist: pdbpp>=0.10.3; extra == "dev"
 Requires-Dist: tox; extra == "dev"
 Requires-Dist: coverage>=5.1; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
@@ -71,12 +77,30 @@ Requires-Dist: pytest-benchmark; extra == "dev"
 Requires-Dist: pytest-clarity; extra == "dev"
 Requires-Dist: pytest-xdist; extra == "dev"
 Requires-Dist: pytest-timeout; extra == "dev"
-Requires-Dist: flake8<5; extra == "dev"
-Requires-Dist: flakeheaven; extra == "dev"
-Requires-Dist: autopep8; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
 Requires-Dist: twine; extra == "dev"
-Requires-Dist: pdoc; extra == "dev"
-Requires-Dist: jupytext; extra == "dev"
+Requires-Dist: jupytext<=1.15; extra == "dev"
+Requires-Dist: mkdocs-material; extra == "dev"
+Requires-Dist: mkdocstrings; extra == "dev"
+Requires-Dist: mkdocstrings-python; extra == "dev"
+Requires-Dist: mkdocs-gen-files; extra == "dev"
+Requires-Dist: mkdocs-literate-nav; extra == "dev"
+Requires-Dist: mkdocs-section-index; extra == "dev"
+Requires-Dist: mkdocs-glightbox; extra == "dev"
+Requires-Dist: mkdocs-jupyter; extra == "dev"
+Requires-Dist: pybtex; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 It is usually best to install from source (github),
 so that you the code is readily available to play with.

{dapper-1.6.0 → dapper-1.7.1}/README.md

@@ -8,7 +8,7 @@
 !
 -->
 
-<img src="/docs/imgs/logo_wtxt.png" align="left" width="250"/>
+<img src="https://github.com/nansencenter/DAPPER/raw/master/docs/images/logos/logo_wtxt.png" align="left" width="250"/>
 
 DAPPER is a set of templates for **benchmarking** the performance of **data assimilation** (DA) methods.
 The numerical experiments provide support and guidance for new developments in DA.
@@ -26,21 +26,19 @@ and then estimate that truth given the models and noisy observations.
 
 ## Getting started
 
-[Install](#installation), then
-read, run and try to understand `examples/basic_{1,2,3}.py`.
-Some of the examples can also be opened in Jupyter, and thereby run in the cloud
-(i.e. *without installation*, but requiring Google login): [![Open In Collab](https://colab.research.google.com/assets/colab-badge.svg)](http://colab.research.google.com/github/nansencenter/DAPPER).
-This [screencast](https://www.youtube.com/watch?v=YtalK0Zkzvg&t=6475s)
-provides an introduction.
-The [documentation](https://nansencenter.github.io/DAPPER)
-includes general guidelines and the API,
-but for any serious use you will want to read and adapt the code yourself.
-If you use it in a publication, please cite, e.g.,
-*The experiments used (inspiration from) DAPPER [ref], version 1.6.0*,
-where [ref] points to [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.10710355.svg)](https://doi.org/10.5281/zenodo.10710355).
-Lastly, for an introduction to DA theory also using Python,
-see these [tutorials](https://github.com/nansencenter/DA-tutorials).
-
+- Read & run [examples](examples)/`basic_1.py` and `basic_2.py`,
+  or their corresponding notebooks [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](http://colab.research.google.com/github/nansencenter/DAPPER)
+  (requires Google login).
+- This [screencast](https://www.youtube.com/watch?v=YtalK0Zkzvg&t=6475s)
+  provides an overview to DAPPER.
+- [Install](#installation).
+- The [documentation](https://nansencenter.github.io/DAPPER)
+  includes general guidelines and the API reference,
+  but most users must expect to read the code as well.
+- If used towards a publication, please cite as
+  *The experiments used (inspiration from) DAPPER [ref], version 1.6.0*,
+  or similar, where [ref] points to [![DOI](https://joss.theoj.org/papers/10.21105/joss.05150/status.svg)](https://doi.org/10.21105/joss.05150).
+- Also see the interactive [tutorials on DA theory](https://github.com/nansencenter/DA-tutorials) with Python.
 
 ## Highlights
 
@@ -50,26 +48,30 @@ through a variety of typical [test cases](#test-cases-models) and statistics. It
 (b) facilitates comparative studies, thus promoting the
 (a) reliability and
 (b) relevance of the results.
-For example, this figure is generated by `examples/basic_3.py`,
-making use of built-in tools for experiment and result management,
+For example, the figure below is generated by `docs/examples/basic_3.py`,
 reproduces figure 5.7 of [these lecture notes](http://cerea.enpc.fr/HomePages/bocquet/teaching/assim-mb-en.pdf).
-
-![Comparative benchmarks with Lorenz'96 plotted as a function of the ensemble size (N)](./docs/imgs/ex3.svg)
-
-DAPPER is (c) open source, written in Python, and (d) focuses on readability;
-this promotes the (c) reproduction and (d) dissemination of the underlying science,
+DAPPER is
+(c) open source, written in Python, and
+(d) focuses on readability;
+this promotes the
+(c) reproduction and
+(d) dissemination of the underlying science,
 and makes it easy to adapt and extend.
 
-It also illustrates how to parallelise ensemble forecasts (e.g. the QG model),
-local analyses (e.g. the LETKF), and independent experiments (e.g. `examples/basic_3.py`).
-It comes with a battery of diagnostics and statistics.
-These all get averaged over subdomains (e..g "ocean" and "land") and then in time.
+![Comparative benchmarks with Lorenz-96 plotted as a function of the ensemble size (N)](https://github.com/nansencenter/DAPPER/raw/master/docs/images/ex3.svg)
+
+DAPPER demonstrates how to parallelise ensemble forecasts (e.g., the QG model),
+local analyses (e.g., the LETKF), and independent experiments (e.g., `docs/examples/basic_3.py`).
+It includes a battery of diagnostics and statistics,
+which all get averaged over subdomains (e.g., "ocean" and "land") and then in time.
 Confidence intervals are computed, including correction for auto-correlations,
 and used for uncertainty quantification, and significant digits printing.
 Several diagnostics are included in the on-line "liveplotting" illustrated below,
 which may be paused for further interactive inspection.
+In summary, DAPPER is well suited for teaching and fundamental DA research.
+Also see its [drawbacks](#similar-projects).
 
-![EnKF - Lorenz'63](./docs/imgs/ex1.jpg)
+![EnKF - Lorenz-96](https://github.com/nansencenter/DAPPER/raw/master/docs/images/ex1.jpg)
 
 <!-- Non-highlighted features:
 - Time sequences use via `tools.chronos.Chronology` and `tools.chronos.Ticker`.
@@ -79,12 +81,9 @@ which may be paused for further interactive inspection.
   provides input flexibility/overloading,
   lazy eval that facilitates the use of non-diagonal
   covariance matrices (whether sparse or full).
+- built-in tools for experiment and result management,
 -->
 
-In summary, DAPPER is well suited for teaching and fundamental DA research.
-Also see its [drawbacks](#similar-projects).
-
-
 ## Installation
 
 Successfully tested on Linux/Mac/Windows.
@@ -98,12 +97,12 @@ open the [Anaconda terminal](https://docs.conda.io/projects/conda/en/latest/user
 and run the following commands:
 
 ```sh
-conda create --yes --name dapper-env python=3.9
+conda create --yes --name dapper-env python=3.12
 conda activate dapper-env
 python --version
 ```
 
-Ensure the printed version is 3.9 or more.  
+Ensure the printed version is as desired.
 *Keep using the same terminal for the commands below.*
 
 ### Install
@@ -114,19 +113,17 @@ Ensure the printed version is 3.9 or more.
 
 - Download and unzip (or `git clone`) DAPPER.
 - Move the resulting folder wherever you like,  
-  and `cd` into it
-  *(ensure you're in the folder with a `setup.py` file)*.
-- `pip install -e '.[dev]'`  
-  You can omit `[dev]` if you don't need to do serious development.
+  and `cd` into it *(ensure you're in the folder with a `setup.py` file)*.
+- `pip install -e '.'`  
 
 #### *Or*: Install as library
 
 *Do you just want to run a script that requires DAPPER?* Then
 
-- If the script comes with a `requirements.txt` file, then do  
+- If the script comes with a `requirements.txt` file that lists DAPPER, then do  
   `pip install -r path/to/requirements.txt`.
 - If not, hopefully you know the version of DAPPER needed. Run  
-  `pip install dapper==1.5.1` to get version `1.5.1` (as an example).
+  `pip install dapper==1.6.0` to get version `1.6.0` (as an example).
 
 #### *Finally*: Test the installation
 
@@ -134,7 +131,7 @@ You should now be able to do run your script with
 `python path/to/script.py`.  
 For example, if you are in the DAPPER dir,
 
-    python examples/basic_1.py
+    python docs/examples/basic_1.py
 
 **PS**: If you closed the terminal (or shut down your computer),
 you'll first need to run `conda activate dapper-env`
@@ -146,16 +143,16 @@ you'll first need to run `conda activate dapper-env`
 <!-- markdownlint-disable line-length -->
 Method                                                 | Literature reproduced
 ------------------------------------------------------ | ------------------------
-EnKF <sup>1</sup>                                      | [Sakov08](https://nansencenter.github.io/DAPPER/bib.html#bib.sakov2008deterministic), [Hoteit15](https://nansencenter.github.io/DAPPER/bib.html#bib.hoteit2015mitigating), [Grudzien2020](https://nansencenter.github.io/DAPPER/bib.html#bib.grudzien2020numerical)
-EnKF-N                                                 | [Bocquet12](https://nansencenter.github.io/DAPPER/bib.html#bib.bocquet2012combining), [Bocquet15](https://nansencenter.github.io/DAPPER/bib.html#bib.bocquet2015expanding)
-EnKS, EnRTS                                            | [Raanes2016](https://nansencenter.github.io/DAPPER/bib.html#bib.raanes2016thesis)
-iEnKS / iEnKF / EnRML / ES-MDA <sup>2</sup>            | [Sakov12](https://nansencenter.github.io/DAPPER/bib.html#bib.sakov2012iterative), [Bocquet12](https://nansencenter.github.io/DAPPER/bib.html#bib.Bocquet12), [Bocquet14](https://nansencenter.github.io/DAPPER/bib.html#bib.bocquet2014iterative)
-LETKF, local & serial EAKF                             | [Bocquet11](https://nansencenter.github.io/DAPPER/bib.html#bib.bocquet2011ensemble)
-Sqrt. model noise methods                              | [Raanes2014](https://nansencenter.github.io/DAPPER/bib.html#bib.raanes2014ext)
-Particle filter (bootstrap) <sup>3</sup>               | [Bocquet10](https://nansencenter.github.io/DAPPER/bib.html#bib.bocquet2010beyond)
-Optimal/implicit Particle filter  <sup>3</sup>         | [Bocquet10](https://nansencenter.github.io/DAPPER/bib.html#bib.bocquet2010beyond)
-NETF                                                   | [Tödter15](https://nansencenter.github.io/DAPPER/bib.html#bib.todter2015second), [Wiljes16](https://nansencenter.github.io/DAPPER/bib.html#bib.wiljes2016second)
-Rank histogram filter (RHF)                            | [Anderson10](https://nansencenter.github.io/DAPPER/bib.html#bib.anderson2010non)
+EnKF <sup>1</sup>                                      | [Sakov08](https://nansencenter.github.io/DAPPER/references/#sakov2008b), [Hoteit15](https://nansencenter.github.io/DAPPER/references/#hoteit2015a), [Grudzien2020](https://nansencenter.github.io/DAPPER/references/#grudzien2020a)
+EnKF-N                                                 | [Bocquet12](https://nansencenter.github.io/DAPPER/references/#bocquet2012a), [Bocquet15](https://nansencenter.github.io/DAPPER/references/#bocquet2015)
+EnKS, EnRTS                                            | [Raanes2016](https://nansencenter.github.io/DAPPER/references/#raanes2016thesis)
+iEnKS / iEnKF / EnRML / ES-MDA <sup>2</sup>            | [Sakov12](https://nansencenter.github.io/DAPPER/references/#sakov2012a), [Bocquet12](https://nansencenter.github.io/DAPPER/references/#Bocquet12), [Bocquet14](https://nansencenter.github.io/DAPPER/references/#bocquet2014)
+LETKF, local & serial EAKF                             | [Bocquet11](https://nansencenter.github.io/DAPPER/references/#bocquet2011)
+Sqrt. model noise methods                              | [Raanes2014](https://nansencenter.github.io/DAPPER/references/#raanes2014)
+Particle filter (bootstrap) <sup>3</sup>               | [Bocquet10](https://nansencenter.github.io/DAPPER/references/#bocquet2010a)
+Optimal/implicit Particle filter  <sup>3</sup>         | [Bocquet10](https://nansencenter.github.io/DAPPER/references/#bocquet2010a)
+NETF                                                   | [Tödter15](https://nansencenter.github.io/DAPPER/references/#todter2015a), [Wiljes16](https://nansencenter.github.io/DAPPER/references/#wiljes2016)
+Rank histogram filter (RHF)                            | [Anderson10](https://nansencenter.github.io/DAPPER/references/#anderson2010)
 4D-Var                                                 |
 3D-Var                                                 |
 Extended KF                                            |
@@ -174,7 +171,7 @@ The particle filter is tuned with "effective-N monitoring",
 "regularization/jittering" strength, and more.
 
 For a list of ready-made experiments with suitable,
-tuned settings for a given method (e.g. the `iEnKS`), use:
+tuned settings for a given method (e.g., the `iEnKS`), use:
 
 ```sh
 grep -r "xp.*iEnKS" dapper/mods
@@ -183,6 +180,9 @@ grep -r "xp.*iEnKS" dapper/mods
 
 ## Test cases (models)
 
+Simple models facilitate the reliability, reproducibility,
+and interpretability of experiment results.
+
 Model                | Lin | TLM** | PDE?  | Phys.dim. | State len | Lyap≥0 | Implementer
 -----------          | --- | ----- | ----  | --------- | --------- | ------ | ----------
 Id                   | Yes | Yes   | No    | N/A       | *         | 0      | Raanes
@@ -351,11 +351,11 @@ and the Center for Western Weather and Water Extremes (CW3E).
 
 <!-- markdownlint-capture -->
 <!-- markdownlint-disable line-length -->
-![NORCE](./docs/imgs/norce-logo.png)
-![NERSC](./docs/imgs/nansen-logo.png)
-<img src="https://github.com/nansencenter/DAPPER/blob/master/docs/imgs/UoR-logo.png?raw=true" height="120" />
-<img src="https://github.com/nansencenter/DAPPER/blob/master/docs/imgs/nceologo1000.png?raw=true" height="100">
-<img src="./docs/imgs/CW3E-Logo-Horizontal-FullColor.png?raw=true" width="400">
+![NORCE](https://github.com/nansencenter/DAPPER/raw/master/docs/images/logos/norce-logo.png)
+![NERSC](https://github.com/nansencenter/DAPPER/raw/master/docs/images/logos/nansen-logo.png)
+<img src="https://github.com/nansencenter/DAPPER/raw/master/docs/images/logos/UoR-logo.png?raw=true" height="120" />
+<img src="https://github.com/nansencenter/DAPPER/raw/master/docs/images/logos/nceologo1000.png?raw=true" height="100">
+<img src="https://github.com/nansencenter/DAPPER/raw/master/docs/images/logos/CW3E-Logo-Horizontal-FullColor.png?raw=true" width="400">
 <!-- markdownlint-restore -->
 
 ## Publications

dapper-1.7.1/dapper/README.md

@@ -0,0 +1,17 @@
+## Adding your own model/method
+
+If you wish to illustrate and run benchmarks with
+your own **model** or **method**, then
+
+- If it is a complex one, you may be better off using DAPPER
+  merely as *inspiration* (but you can still
+  [cite it](../#getting-started))
+  rather than trying to squeeze everything into its templates.
+- If it is relatively simple, however, you may well want to use DAPPER.
+  In that case, read this:
+    - [`mods`](mods)
+    - [`da_methods`](da_methods)
+
+Since the generality of DAPPER is
+[limited](../#similar-projects)
+it is quite likely you will also need to make changes to the DAPPER code itself.

{dapper-1.6.0 → dapper-1.7.1}/dapper/__init__.py

@@ -1,10 +1,10 @@
 """Root package of **DAPPER**
 (Data Assimilation with Python: a Package for Experimental Research)
 
-.. include:: ./README.md
+--8<-- "dapper/README.md"
 """
 
-__version__ = "1.6.0"
+__version__ = "1.7.1"
 
 # A parsimonious list of imports used in the examples
 from .dpr_config import rc

{dapper-1.6.0 → dapper-1.7.1}/dapper/da_methods/README.md

@@ -1,6 +1,4 @@
-Also see the section on
-[DA Methods](https://github.com/nansencenter/DAPPER#DA-Methods)
-in the main README
+Also see [this section on DA Methods](../../#da-methods)
 for an overview of the methods included with DAPPER.
 
 ## Defining your own method
@@ -8,7 +6,7 @@ for an overview of the methods included with DAPPER.
 Follow the example of one of the methods within one of the
 sub-directories/packages.
 The simplest example is perhaps
-`dapper.da_methods.ensemble.EnKF`.
+[`da_methods.ensemble.EnKF`][].
 
 ## General advice for programming/debugging scientific experiments
 

{dapper-1.6.0 → dapper-1.7.1}/dapper/da_methods/__init__.py

@@ -1,7 +1,8 @@
 """Contains the data assimilation methods included with DAPPER.
 
-.. include:: ./README.md
+--8<-- "dapper/da_methods/README.md"
 """
+
 from pathlib import Path
 
 
@@ -15,7 +16,7 @@ def da_method(*default_dataclasses):
     The decorated classes are defined like a `dataclass`,
     but are decorated by `@da_method()` instead of `@dataclass`.
 
-    .. note::
+    !!! note
         The classes must define a method called `assimilate`.
         This method gets slightly enhanced by this wrapper which provides:
 
@@ -24,7 +25,8 @@ def da_method(*default_dataclasses):
         - Duration timing
         - Progressbar naming magic.
 
-    Example:
+    Examples
+    --------
     >>> @da_method()
     ... class Sleeper():
     ...     "Do nothing."
@@ -42,7 +44,6 @@ def da_method(*default_dataclasses):
     which enables defining default parameters which can be inherited,
     similar to subclassing.
 
-    Example:
     >>> class ens_defaults:
     ...     infl : float = 1.0
     ...     rot  : bool  = False
@@ -55,13 +56,13 @@ def da_method(*default_dataclasses):
     ...     def assimilate(self, HMM, xx, yy):
     ...         ...
 
-    .. note::
+    !!! note
         Apart from what's listed in the above `Note`, there is nothing special to the
         resulting `xp`.  That is, just like any Python object, it can serve as a data
         container, and you can write any number of attributes to it (at creation-time,
         or later).  For example, you can set attributes that are not used by the
         `assimilate` method, but are instead used to customize other aspects of the
-        experiments (see `dapper.xp_launch.run_experiment`).
+        experiments (see [`xp_launch.run_experiment`][]).
     """
     import dataclasses
     import functools
@@ -82,7 +83,7 @@ def da_method(*default_dataclasses):
         def set_field(name, type_, val):
             """Set the inherited (i.e. default, i.e. has value) field."""
             # Ensure annotations
-            cls.__annotations__ = getattr(cls, '__annotations__', {})
+            cls.__annotations__ = getattr(cls, "__annotations__", {})
             # Set annotation
             cls.__annotations__[name] = type_
             # Set value
@@ -102,7 +103,7 @@ def da_method(*default_dataclasses):
         # Define the new assimilate method (has bells and whistles)
         def assimilate(self, HMM, xx, yy, desc=None, fail_gently=False, **stat_kwargs):
             # Progressbar name
-            pb_name_hook = self.da_method if desc is None else desc # noqa
+            pb_name_hook = self.da_method if desc is None else desc  # noqa
 
             # Init stats
             self.stats = dapper.stats.Stats(self, HMM, xx, yy, **stat_kwargs)
@@ -120,7 +121,7 @@ def da_method(*default_dataclasses):
                     # Don't use _print_cropped_traceback here -- It would
                     # crop out errors in the DAPPER infrastructure itself.
                     raise
-            self.stat("duration", time.time()-time0)
+            self.stat("duration", time.time() - time0)
 
         # Overwrite the assimilate method with the new one
         try:
@@ -128,12 +129,14 @@ def da_method(*default_dataclasses):
         except AttributeError as error:
             raise AttributeError(
                 "Classes decorated by da_method()"
-                " must define a method called 'assimilate'.") from error
+                " must define a method called 'assimilate'."
+            ) from error
         cls.assimilate = functools.wraps(_assimilate)(assimilate)
 
         # Shortcut for register_stat
         def stat(self, name, value):
             dapper.stats.register_stat(self.stats, name, value)
+
         cls.stat = stat
 
         # Make self.__class__.__name__ an attrib.
@@ -141,6 +144,7 @@ def da_method(*default_dataclasses):
         cls.da_method = cls.__name__
 
         return cls
+
     return dataclass_with_defaults
 
 
@@ -155,15 +159,17 @@ def _print_cropped_traceback(ERR):
         msg = "Traceback (most recent call last):\n"
         try:
             # If in IPython, use its coloring functionality
-            __IPYTHON__  # type: ignore
+            __IPYTHON__  # type: ignore # noqa: B018
         except (NameError, ImportError):
             msg += "".join(traceback.format_tb(ERR.__traceback__))
         else:
             from IPython.core.debugger import Pdb
+
             pdb_instance = Pdb()
             pdb_instance.curframe = inspect.currentframe()
 
             import dapper.da_methods
+
             keep = False
             for frame in traceback.walk_tb(ERR.__traceback__):
                 if keep:
@@ -175,10 +181,12 @@ def _print_cropped_traceback(ERR):
         return msg
 
     msg = crop_traceback(ERR) + "\nError message: " + str(ERR)
-    msg += ("\n\nResuming execution."
-            "\nIf instead you wish to raise the exceptions as usual,"
-            "\nwhich will halt the execution (and enable post-mortem debug),"
-            "\nthen use `fail_gently=False`")
+    msg += (
+        "\n\nResuming execution."
+        "\nIf instead you wish to raise the exceptions as usual,"
+        "\nwhich will halt the execution (and enable post-mortem debug),"
+        "\nthen use `fail_gently=False`"
+    )
     print(msg, file=sys.stderr)