Clarify how to pass options to calculate

[aidalgol]

Add examples of defining a calculation with keyword options.

Relates to #1534

Contributor checklist

• [ ] Bug fixes include regression tests
• [ ] Chores
• [x] Documentation changes
• [ ] Features include unit/acceptance tests
• [ ] Refactoring
• [ ] Update dependencies