Skip to content

About

The code included in the Springer Owl book

Resources

Stars

7 stars

Watchers

3 watching

Forks

Latest commit

 

History

32 Commits

Folders and files

Repository files navigation

springer-book-code

The code included in the Springer Owl book.

Second edition environment

CI uses incremental verification: documentation changes do not build images; ordinary changes run the affected examples, reusing matching full results for unchanged chapters. Pull requests use short real checks for LDA/style training. Environment changes invalidate the old full results. Manual Actions runs offer auto, quick (never publishes) and full (reruns everything). Daily checks skip the build when upstream versions and runtime inputs match :latest. See the verification policy.

New self-contained examples go in code/chapXX_*/examples/name.ml. They are compiled and run automatically by scripts/book_examples.py when new or changed. Image validation checks their complete execution evidence. No edit to historical listing or plot manifests is needed. The manuscript repository provides make example-new, make example and make examples for creation and publication export; see its contributor guide. Optional sibling name.json selects installed findlib packages/runtime limits; name.data/ supplies local inputs exposed as data/ during execution.

Restoration includes the original datasets/model inputs where recovered, native runners and actual OCaml sessions. Chapter 12 performs all 1000 LDA iterations; Chapter 15 performs 250 NST and ten 100-update reconstruction runs, and verifies all six FST models. Some printed shapes, quotations, protocol and incomplete weight-exchange fragments are explicitly illustrative rather than executable.

The author approved second-edition replacements for the former 18 blocked regions: Chapter 6 uses native RK45 and ODEPACK; Chapter 7 ships clearly labelled synthetic CSV inputs with a fixed generator; Appendix A uses explicit precision conversion in place of Owl.Ext. All 398 original IDs remain traceable (389 code/interface blocks and 9 illustrative blocks); no blocked region remains in the current map. The updated local image passes complete build-time and independent reader/PTY validation. Illustrations are not counted as executed programs. The exact latest-compiler/Owl environment includes recorded RK45 and blocked convolution accuracy corrections plus CamlImages build compatibility changes. All 18 publication snapshots, both code styles and the independent publisher package pass. Consult the manuscript repository's STATUS.md for the immutable image, exact source evidence and next review steps.

CI updates matrixanger/springer-book-code:latest after main-branch pushes and daily builds pass the full book and registry-pull checks. Each publication pushes a unique build-<code revision>-<run ID> tag and then deletes the older build tags. Failed checks preserve the previous reader image. The former :pilot alias is retired. To keep an edition's image, give it its own tag (for example edition-2); such tags are never deleted. Local candidate tags are not Docker Hub release tags.

About

The code included in the Springer Owl book

Resources

Stars

7 stars

Watchers

3 watching

Forks

Releases

Packages

Contributors

Languages