Skip to main content

Design and techno-economic assessment of marine renewable energy arrays.

Reason this release was yanked:

Dropped Python 3.14 support

Project description

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dtocean-2026.3.3.tar.gz (4.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

dtocean-2026.3.3-py3-none-any.whl (3.7 kB view details)

Uploaded Python 3

File details

Details for the file dtocean-2026.3.3.tar.gz.

File metadata

  • Download URL: dtocean-2026.3.3.tar.gz
  • Upload date:
  • Size: 4.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for dtocean-2026.3.3.tar.gz
Algorithm Hash digest
SHA256 d9f0e3f115e00eedc91bd4974b0b4f0c6ac6e84e8de2989f32e43c7dc10df566
MD5 74a69d8f910f6f8686d8283e4dde3dde
BLAKE2b-256 a894ef0cb010c5ed06ebb726502441c3a7573abd0e5f6aad9fd54da82aa4f2c1

See more details on using hashes here.

Provenance

The following attestation bundles were made for dtocean-2026.3.3.tar.gz:

Publisher: release.yml on DTOcean/dtocean

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file dtocean-2026.3.3-py3-none-any.whl.

File metadata

  • Download URL: dtocean-2026.3.3-py3-none-any.whl
  • Upload date:
  • Size: 3.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for dtocean-2026.3.3-py3-none-any.whl
Algorithm Hash digest
SHA256 41f746167b086f07ff431c639f814f7d791ab9780c642944f78ce17c844a8bbb
MD5 327bdfd7f2780a6725260a8faa5c4e6b
BLAKE2b-256 1ac76c4e3523f1a7325f392660a006af261afa3f6e012b687377bb513744933c

See more details on using hashes here.

Provenance

The following attestation bundles were made for dtocean-2026.3.3-py3-none-any.whl:

Publisher: release.yml on DTOcean/dtocean

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page