Skip to main content
Change of provenance

The repository or configuration that created this release differ from a previous release. View details.

MAICoS

MAICoS logo

GitHub Actions Tests Job Status Code coverage Documentation of stable released version Documentation of latest unreleased version Powered by MDAnalysis

MAICoS stands for Molecular Analysis for Interfacial and Confined Systems. It is an object-oriented Python toolkit for analyzing the structure and dynamics of interfacial and confined fluids from molecular simulations. Combined with MDAnalysis, MAICoS enables the extraction of density profiles, dielectric constants, and transport properties from trajectory files generated by LAMMPS, GROMACS, CHARMM, or NAMD simulations. MAICoS is open source and released under the GNU General Public License v3.0.

MAICoS is designed both for beginners in molecular simulations with no prior Python experience— offering a descriptive Command Line Interface (CLI)—and for experienced users who can use the Python API for day-to-day analysis or build their own workflows for interfacial and confined systems.

Stay up to date with MAICoS news by following us on X. If you encounter any issues, report them on GitHub, or join our developer community on Discord to discuss features and improvements.

Basic Example

Here is a simple example showing how to use MAICoS to extract a density profile from a molecular dynamics simulation. The files conf.gro and traj.trr correspond to output files from a GROMACS simulation. In a Python environment, type:

import MDAnalysis as mda
import maicos

u = mda.Universe("conf.gro", "traj.trr")
dplan = maicos.DensityPlanar(u.atoms).run()

The density profile is stored in dplan.results.profile, and the corresponding bin positions are available in dplan.results.bin_pos.

Documentation

For details, tutorials, and examples, visit our official documentation. We also provide the latest documentation for the current development version of MAICoS.

Installation

Install MAICoS using pip:

pip install maicos

Or with conda from conda-forge:

conda install -c conda-forge maicos

List of Analysis Modules

Currently, MAICoS supports the following analysis modules (alphabetically):

Module

Description

DensityCylinder

Cylindrical partial density profiles

DensityPlanar

Cartesian partial density profiles

DensitySphere

Spherical partial density profiles

DielectricCylinder

Cylindrical dielectric profiles

DielectricPlanar

Planar dielectric profiles

DielectricSphere

Spherical dielectric profiles

DiporderCylinder

Cylindrical dipolar order parameters

DiporderPlanar

Planar dipolar order parameters

RDFDiporder

Spherical radial distribution function between dipoles

DiporderSphere

Spherical dipolar order parameters

PDFCylinder

Cylindrical shell-wise 1D pair distribution functions

PDFPlanar

Slab-wise planar 2D pair distribution functions

TemperaturePlanar

Temperature profiles in a Cartesian geometry

VelocityCylinder

Cylindrical velocity profiles

VelocityPlanar

Velocity profiles in a Cartesian geometry

Contributors

Thanks to all contributors who make MAICoS possible:

https://contrib.rocks/image?repo=atomistic-lab/maicos

Metadata

Release files for maicos 0.13.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Change of provenance

The repository or configuration that created these release files differ from that of a previous release.

We recommend inspecting the repository and configuration before proceeding. View details.

Source distribution (sdist)

Source distribution for maicos 0.13.1
File Size Uploaded Provenance Actions
maicos-0.13.1.tar.gz 90.5 kB With provenance Details for maicos-0.13.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for maicos 0.13.1
File Interpreter ABI Platform Actions
maicos-0.13.1-py3-none-any.whl Python 3 none any Details for maicos-0.13.1-py3-none-any.whl

Total release size: 189.7 kB

Release files / maicos-0.13.1.tar.gz

Change of provenance

This file belongs to a release with changed provenance: the repository or configuration that created the release files differ from that of a previous release.

We recommend inspecting the repository and configuration before proceeding. View details.

Download URL maicos-0.13.1.tar.gz
Size 90.5 kB
Tags Source
SHA-256 checksum
How to use checksums
e7c456f6fc0d09a3728617397495a7ca37858732220bb7e1a30788ae389cb7ca
BLAKE2b-256 checksum
How to use checksums
78e789c2ad8fe23442e68b1863850963462aa2131b06b5ce399b1c435e82b852
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 10, 2026.

Transparency log

Release files / maicos-0.13.1-py3-none-any.whl

Change of provenance

This file belongs to a release with changed provenance: the repository or configuration that created the release files differ from that of a previous release.

We recommend inspecting the repository and configuration before proceeding. View details.

Download URL maicos-0.13.1-py3-none-any.whl
Size 99.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2000576cac23eb794026f38d62772255d85b4584a5ce5247c3fa51d17ba9a5e3
BLAKE2b-256 checksum
How to use checksums
cdf313eb66980a7b3af698ce9780676114eecea4327f9a1b9befa1ff4b5058fd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 10, 2026.

Transparency log

Security for maicos 0.13.1

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.

Change of provenance

The repository and configuration that created this release differ from a previous release.

While this could reflect a routine change by the project maintainers, it may also indicate that the release files have been compromised.

Select from 2 files

Attestation for maicos-0.13.1.tar.gz

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 Nov 10, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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