Skip to content

Improve documentation for solve function results #951

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 1 commit into from

Conversation

ChrisRackauckas
Copy link
Member

Summary

This PR addresses issue #587 by adding comprehensive documentation about the OptimizationSolution object returned by the solve() function.

Changes

  • Enhanced docs/src/API/solve.md with a new section "Understanding the Solution Object" that includes:
    • Detailed explanation of all solution fields (u/minimizer, objective/minimum, retcode, stats, etc.)
    • Clear documentation about the aliases (u/minimizer and objective/minimum)
    • Example code showing how to access and use solution information
    • Documentation of the array interface
  • Enhanced docs/src/API/optimization_solution.md with:
    • Quick reference for commonly used fields
    • Explanation of the alias relationships
    • Cross-reference to the solve documentation

Test plan

The documentation includes working code examples that demonstrate:

  • How to access the solution vector using both sol.u and sol.minimizer
  • How to access the objective value using both sol.objective and sol.minimum
  • How to check the return code and optimization statistics
  • How to use the array interface

These examples use the standard Rosenbrock function example for consistency with other documentation.

Closes #587

🤖 Generated with Claude Code

Addresses issue #587 by adding comprehensive documentation about the OptimizationSolution object returned by solve(), including:
- Detailed explanation of all solution fields (u/minimizer, objective/minimum, retcode, stats, etc.)
- Clear documentation about the aliases (u/minimizer and objective/minimum)
- Example code showing how to access and use solution information
- Array interface documentation
- Cross-references between related documentation pages

This helps users understand what properties are available in the solution object and how to use them effectively.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
@ChrisRackauckas ChrisRackauckas deleted the improve-solve-result-documentation branch July 24, 2025 10:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

The help to solve does not explain the result.
1 participant