Interested in contributing a code example?
Please take a look at our contribution guidelines before getting started. Thanks!
Describe your example and specify what it is demonstrating. Consider the following questions:
- Is it pedagogical or a usable application?
- Does it belong to a particular domain such as material simulation or logistics?
- What level of Ocean proficiency does it target (beginner, advanced, pro)?
A clear description allows us to properly categorize your example.
Images are encouraged. If your example produces a visualization, consider displaying it here.
A simple command that runs your program. For example,
python <demo_name>.pyIf your example requires user input, make sure to specify the input format and any input limitations.
An example program output.
Objectives to be optimized: the goals the process attempts to accomplish by minimizing or maximizing certain aspects of the problem to the extent possible; for example, a production-line optimization might attempt to minimize the time to produce all of the products.
Constraints: aspects of the problem and/or process, with limited or no flexibility, that must be satisfied for solutions to be considered feasible; for example, a production-line optimization might have a limitation that Machine A can only bend 10 parts per hour.
The clearer your model is presented here, the more useful it will be to others. For a strong example of this section, see here.
List and define the parameters used in your model.
List and define (including type: e.g., "binary" or "integer") the variables solved for in your model.
List and define any combinations of variables used for easier representations of the models.
Mathematical formulation of the objective described in the previous section using the listed parameters, variables, etc.
Mathematical formulation of the constraints described in the previous section using the listed parameters, variables, etc.
A general overview of how the code works.
We prefer descriptions in bite-sized bullet points:
- Here's an example bullet point
Notable parts of the code implementation.
This is the place to:
- Highlight a part of the code implementation
- Talk about unusual or potentially difficult parts of the code
- Explain a code decision
- Explain how parameters were tuned
Note: there is no need to repeat everything that is already well-documented in the code.
A. Person, "Title of Amazing Information", short link name
Released under the Apache License 2.0. See LICENSE file.