Ocellaris is a mass-conserving DG FEM solver for sharp-interface multiphase free-surface flows. Ocellaris can simulate water entry and exit of objects in ocean waves with accurate capturing of the force on the object and the behaviour of the free surface. Some examples of what Ocellaris can do, including videos of the results, are shown in the Ocellaris Blog on www.ocellaris.org.
Ocellaris is implemented in Python and C++ with FEniCS as the backend for the mesh and finite element assembly. PETSc is used for solving the resulting linear systems.
Ocellaris is named after the Amphiprion Ocellaris clownfish and is written as part of a PhD project at the University of Oslo.
Installation and running
Ocellaris requires a full installation of FEniCS with the PETSc linear algebra backend. You can install the dependencies yourself (you need at least dolfin, h5py, matplotlib and PyYAML), but the easiest way by far is to use a preconfigured Singularity or Docker container. More information on these and installation in general can be found in the user guide.
When Ocellaris is installed you can run the solver with an Ocellaris input file:
ocellaris INPUTFILE.INP
Example input files can be found in the demos/ sub-directory of the Ocellaris source code and a description of the Ocellaris input file format and the possible input parameters is given in the user guide.
First steps
To test the code there are some demo input files in the demos/ directory. Complete input files along with driver scripts are provided for several of the standard benchmark cases like Kovasznay flow and the Taylor-Green vortex in the cases/ directory. More information can be found in the documentation which also contains a description of the input file format.
Please feel free to test Ocellaris, but please keep in mind:
Ocellaris is in a state of constant development
Ocellaris is tested with FEniCS Version 2018.1. Earlier versions will NOT work, later version may possibly work.
This is an ongoing research project, do not expect results to be correct without proper validation!
Documentation
The documentation can be found on the Ocellaris web page.
Development
Ocellaris is developed in Python and C++ on Bitbucket by use of the Git version-control system. If you are reading this on github, please be aware that you are seeing a mirror that could potentially be months out of date. The github mirror is only updated sporadically—to trigger new Singularity and Docker Hub container builds. All pull requests and issues should go to the Bitbucket repository. If you want to contribute to Ocellaris, please read the guide to contributing.
Ocellaris is automatically tested on CircleCI
and the current CI build status is 
Copyright and license
Ocellaris is copyright Tormod Landet, 2014-2019, and the Ocellaris project contributors from 2019 and onwards. Ocellaris is licensed under the Apache 2.0 license, a permissive free software license compatible with version 3 of the GNU GPL. See License of Ocellaris for the details.
1 maintainer
Metadata
1 maintainer
Release files for ocellaris 2019.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ocellaris-2019.1.0.tar.gz | 242.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ocellaris-2019.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 573.5 kB
Release files / ocellaris-2019.1.0.tar.gz
| Download URL | ocellaris-2019.1.0.tar.gz |
|---|---|
| Size | 242.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
55e3fb3dbc35e6eef88e07a21e2cefb8dda529095f5b092fa5680407b85ab8f6
|
|
BLAKE2b-256 checksum How to use checksums |
5d3fb1fc9eaad8e820d14aed4766c491b5125a865932868786c54ee17551520f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.8.0 tqdm/4.29.0 CPython/3.6.6
|
Release files / ocellaris-2019.1.0-py3-none-any.whl
| Download URL | ocellaris-2019.1.0-py3-none-any.whl |
|---|---|
| Size | 330.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7b54936ae12833f2be5817ea8013aac51fcb9dc177d95c2437701f434c9f9e4a
|
|
BLAKE2b-256 checksum How to use checksums |
138957cab0695181313e75e9cf239d62c81f2e9a9c19047cc1fda19b0cbc2110
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.8.0 tqdm/4.29.0 CPython/3.6.6
|
