:loudspeaker: This project is currently in beta while I finish converting the Python2 modules to Python3. Please consider sponsoring my work. Many thanks.
DTOcean
DTOcean is an open-source tool for design and techno-economic assessment of marine renewable energy arrays.
DTOcean can calculate:
- Optimal ocean energy converter (OEC) positioning
Energy export infrastructureStation keeping requirements based on OEC performance and site conditionsInstallation planning with weather effectsMaintenance planning, simulating OEC downtimeEnvironmental impact assessment (experimental)
And features include:
- A unique statistical approach to calculating levelized cost of energy (LCOE)
OEC reliability influenced at component level- Graphical user interface
- Persistent database
(Features currently unavailable but planned for reimplementation are struck out.)
Installation
Install the DTOcean suite of packages using pip:
pip install dtocean
After installation, download necessary data files and setup desktop shortcuts using the following command:
dtocean init
Database
See the dtocean-database repository for download and installation instructions.
Usage
Open the DTOcean GUI using the DTOcean shortcut or from a command prompt:
dtocean app
Command Line Tools
The dtocean command provides universal access to the command line tools for
all of the install modules. Documentation for each subcommand can be found in
the table below.
| subcommand | help |
|---|---|
| init | Run module initialization (requires internet connection) |
| app | See dtocean-app |
| core | See dtocean-core |
| database | See dtocean-core |
| docs | See dtocean-docs |
| hydrodynamics | See dtocean-hydrodynamics |
Example Files
The examples archive (in zip or tar.gz format) can be downloaded from the
latest release
of the dtocean-examples
repository. See the "Getting Started 1: Example Project" chapter of the
docs for usage instructions.
Documentation
See https://dtocean.github.io/dtocean for
the latest documentation. The documentation can also be accessed from the
Help menu of the GUI using the Index... command or using the dtocean docs
command line tool.
Various video tutorials can also be found on the Data Only Greater YouTube Channel.
Contributing
Please see the contributing guidelines for information regarding the structure of the DTOcean GitHub repository, the tools required for setting up development and how to offer contributions to the project.
Credits
This version of DTOcean was developed and published by Mathew Topper at Data Only Greater as a continuation of the EU FP7 DTOcean project.
Also, please check out the EU H2020 DTOceanPlus project, which expanded the scope of the DTOcean tools. The source code for DTOceanPlus is available from gitlab.com.
Licence and Attributions
Other licenses may apply to individual components. Please see the source code for full licensing information.
While not required by the terms of the license, if you would like to acknowledge the use of DTOcean in a publication, you may choose to cite:
Topper, M. B., Olson, S. S., & Roberts, J. D. (2021). On the benefits of negative hydrodynamic interactions in small tidal energy arrays. Applied Energy, 297, 117091. Retrieved from https://doi.org/10.1016/j.apenergy.2021.117091
Topper, M. B., Olson, S. S., & Roberts, J. D. (2020). Techno-economic modelling of tidal energy converter arrays in the tacoma narrows. Journal of Marine Science and Engineering, 8(9), 646. Retrieved from https://doi.org/10.3390/jmse8090646
Topper, M. B. R., Nava, V., Collin, A. J., Bould, D., Ferri, F., Olson, S. S., ... & Jeffrey, H. F. (2019). Reducing variability in the cost of energy of ocean energy arrays. Renewable and Sustainable Energy Reviews, 112, 263-279. Retrieved from https://doi.org/10.1016/j.rser.2019.05.032
Metadata
Release files for dtocean 2026.4.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| dtocean-2026.4.2.tar.gz | 4.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| dtocean-2026.4.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 7.7 kB
Release files / dtocean-2026.4.2.tar.gz
| Download URL | dtocean-2026.4.2.tar.gz |
|---|---|
| Size | 4.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2078ce48823754f414fc24f15f8a79800b6786acf172adf6a0bfe6014e8e05c5
|
|
BLAKE2b-256 checksum How to use checksums |
ed0f85b29f62c99d5a92a5bfe9a2fb74fd5212f4475a487310ff62333ceed9b4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 22, 2026.
Transparency logRelease files / dtocean-2026.4.2-py3-none-any.whl
| Download URL | dtocean-2026.4.2-py3-none-any.whl |
|---|---|
| Size | 3.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
08eb15589dc7edea212497dee5a9581180187d02ad44d1a5301ad8f1509abd00
|
|
BLAKE2b-256 checksum How to use checksums |
fbe8374e5a1841067ef1cb851e25cfc6e9e19d481090bf75c728d56576de8b48
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 22, 2026.
Transparency log