Fix docs build: explicit JumpProcesses/StochasticDiffEq imports after DiffEq 8.0#594
Merged
ChrisRackauckas merged 1 commit intoMay 23, 2026
Conversation
…Eq 8.0 DifferentialEquations.jl v8.0.0 only reexports SciMLBase and OrdinaryDiffEq, dropping the JumpProcesses, StochasticDiffEq, DiffEqNoiseProcess, DiffEqCallbacks and other reexports it used to provide in v7. The docs tutorials were relying on `using DifferentialEquations` to bring `JumpProblem`, `ConstantRateJump`, `VariableRateJump`, `Direct`, `SSAStepper`, `SRIW1`, etc. into scope, which caused the Documenter build to fail with `UndefVarError: JumpProblem not defined` at jump_diffusion.md:163 and similar errors in discrete_stochastic_example.md once docs/Project.toml was bumped to allow DifferentialEquations 8.0. Replace `using DifferentialEquations` with explicit `using JumpProcesses, OrdinaryDiffEq[, StochasticDiffEq]` in the affected tutorial @example blocks, @setup blocks, and corresponding Pkg.add prose. simple_poisson_process.md already imported JumpProcesses directly and is unaffected. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> Co-Authored-By: Chris Rackauckas <accounts@chrisrackauckas.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
The Documentation workflow has been failing on
mastersince 2026-05-11 (PR #591, the dependabotDifferentialEquations 7.11 -> 8.0bump indocs/Project.toml).DifferentialEquations.jlv8.0.0 only reexportsSciMLBaseandOrdinaryDiffEq. It no longer reexportsJumpProcesses,StochasticDiffEq,DiffEqNoiseProcess,DiffEqCallbacks, etc. As a result,using DifferentialEquationsin the tutorials no longer brings symbols likeJumpProblem,ConstantRateJump,VariableRateJump,Direct,SSAStepper, orSRIW1into scope, and the Documenter build fails with:The "also exported by ModelingToolkitBase / Catalyst" hints in Documenter's output are red herrings emitted because those packages are loaded elsewhere in the build — they do not actually shadow
JumpProcesses.JumpProblem. The root cause is the lost reexport in DifferentialEquations 8.0.Fix
Replace
using DifferentialEquationswith explicit imports in the two affected tutorial files:docs/src/tutorials/jump_diffusion.md(tut3):using JumpProcesses, StochasticDiffEq, OrdinaryDiffEq, Plotsdocs/src/tutorials/discrete_stochastic_example.md(tut2@exampleand@setupblocks):using JumpProcesses, OrdinaryDiffEq, Plots, LinearAlgebraUpdated the corresponding
Pkg.addprose to match.docs/src/tutorials/simple_poisson_process.mdalready uses explicitusing JumpProcesses, Plotsand was not affected.Verification
Reproduced the failure locally against the current
docs/Project.toml(DifferentialEquations 8.0.0, Catalyst 16.1.1, ModelingToolkitBase 1.35.0) on Julia 1.11:After the fix, ran the full code from both tutorials end-to-end with
using JumpProcesses, StochasticDiffEq, OrdinaryDiffEq, Plots(fortut3) andusing JumpProcesses, OrdinaryDiffEq, Plots, LinearAlgebra+using Catalyst(fortut2): both complete successfully.Test plan
🤖 Generated with Claude Code