Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

6,228 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

esys-escript

esys-escript is a module for implementing mathematical models in Python using the finite element method (FEM). As users do not access the underlying data structures, it is very easy to use, and scripts can run on desktop computers as well as massive parallel supercomputers without changes. Application areas for esys-escript include geophysical inversion, earthquakes, porous media flow, reactive transport, plate subduction, erosion, Earth mantle convection, and tsunamis.

esys-escript is designed as an easy-to-use environment for implementing mathematical models based on non-linear, coupled, time-dependent partial differential equations. It uses the finite element method (FEM) for spatial discretisation and data representation and is used through Python. It is suitable for rapid prototyping (e.g. for a student project or thesis) as well as for large software projects. Scripts are executed sequentially, on multi-core platforms via OpenMP and distributed computing clusters using MPI. The hybrid mode of OpenMP and MPI is supported and allows for solving problems with over 200 million unknowns on several thousand cores on a parallel computer.

For geophysical inversion, see also the extensions gambit and fingal.

Latest release: 6.1.1

The latest release is esys-escript 6.1.1, a maintenance release that builds on 6.1.0 with improved build and packaging support across platforms.

Highlights of 6.1.1:

  • Windows (MSVC) build fixes — esys-escript now compiles cleanly with the MSVC toolchain.
  • macOS: shared libraries and Python extensions carry an RPATH so import esys.escript works without run-escript; fixed an OpenMP duplicate-runtime abort in Homebrew builds.
  • conda-forge and pip packaging improvements (bare-import support and the lib-path bootstrap).
  • More robust build-system probes: Boost.NumPy detection, the MUMPS MPI shim header, and the gmsh GEO templates.
  • The run-escript man page is brought in line with the launcher's options.

6.1.0 introduced the major features: Trilinos v17.0.0 (bundled, built in-tree), the new SolverFramework API, HDF5 dumping/loading for Data (replacing the mandatory netCDF dependency), the InterpolationTable class, and macOS arm64 (Apple Silicon) support.

See RELEASE_NOTES for the full change list.

Main Features:

  • Python-based user interface
  • two- and three-dimensional finite and spectral element simulations
  • specialised geophysical inversion module
  • support for VTK and SILO file format
  • unstructured meshes from gmsh
  • parallelisation with OpenMP and MPI support
  • Flux Controlled Transport solver (FEM-FCT)
  • visualisation with VisIt, paraview, mayavi and others
  • primary platform is Linux; macOS is supported for builds from source; on Windows, use WSL2

Access:

Source code is available at https://github.com/LutzGross/esys-escript.github.io.

A version of the documentation for the current master branch is available here.

Questions & Bugs

To raise a question or to report a bug, please start a github issue.

Linux or MacOS Installation from Source

Please inspect the installation guide for information on a specific Linux distribution.

Debian Distribution

Debian packages python3-escript and python3-escript-mpi are available: version 5.6 in Debian stable (trixie) and oldstable (bookworm), and version 6.1.1 in Debian unstable (sid). Install with

sudo apt install python3-escript

or python3-escript-mpi for the MPI version. Of the Ubuntu releases, only 22.04 (jammy) has these packages (version 5.6).

Conda Installation

To install esys-escript from conda-forge, run

conda install esys-escript -c conda-forge

conda-forge currently provides version 5.10, for Linux only. Packages of version 6.1.1 for Linux, macOS and Windows will follow once the conda-forge feedstock has been updated.

Windows

On Windows, use WSL2 (Windows Subsystem for Linux) and follow the Linux instructions: in a Debian WSL2 distribution, install the Debian package, or build from source, see the Windows section of the installation guide.

Using esys-escript

Online documentation for master branch is available here.

Reference

If you publish work that makes use of esys-escript, we would appreciate it if you would cite the following reference:

License

Copyright (c) 2003-2026 by the esys.escript Group. The majority of the files contained in this distribution are licensed under the Apache License, version 2.0, http://www.apache.org/licenses/LICENSE-2.0, see LICENSE.

Contributors

Esys-escript started in 2003 as one of the first projects that made systemic use of the Python language for large-scale scientific computing. It is the product of years of work by many people with funding from the Australian Commonwealth, see CREDITS.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages