Skip to main content

dtocean actions codecov PyPI - Python Version


: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 infrastructure
  • Station keeping requirements based on OEC performance and site conditions
  • Installation planning with weather effects
  • Maintenance planning, simulating OEC downtime
  • Environmental 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

GPL-3.0

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)

Source distribution for dtocean 2026.4.2
File Size Uploaded
dtocean-2026.4.2.tar.gz 4.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for dtocean 2026.4.2
File Interpreter ABI Platform
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 log

Release 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

Release history Release notifications | RSS feed

This release

2026.4.2 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page