Analyse molecular dynamics simulations of interfacial and confined systems.
Project description
MAICoS is the acronym for Molecular Analysis for Interfacial and Confined Systems. It is an object-oriented python toolkit for analysing the structure and dynamics of interfacial and confined fluids from molecular simulations. Combined with MDAnalysis, MAICoS can be used to extract density profiles, dielectric constants, structure factors, or transport properties from trajectories files, including LAMMPS, GROMACS, CHARMM or NAMD data. MAICoS is open source and is released under the GNU general public license v3.0.
MAICoS is a tool for beginners of molecular simulations with no prior Python experience. For these users MAICoS provides a descriptive command line interface. Also experienced users can use the Python API for their day to day analysis or use the provided infrastructure to build their own analysis for interfacial and confined systems.
Keep up to date with MAICoS news by following us on Twitter. If you find an issue, you can report it on Gitlab. You can also join the developer team on Discord to discuss possible improvements and usages of MAICoS.
Basic example
This is a simple example showing how to use MAICoS to extract the density profile from a molecular dynamics simulation. The files conf.gro and traj.trr correspond to simulation files from a GROMACS simulation package. 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 can be accessed from dplan.results.profile and the position of the bins from dplan.results.bin_pos.
Documentation
For details, tutorials, and examples, please have a look at our documentation. If you are using an older version of MAICoS, you can access the corresponding documentation on ReadTheDocs.
Installation
Install MAICoS using pip with:
pip install maicos
or using conda with:
conda install -c conda-forge maicos
List of analysis modules
Currently, MAICoS supports the following analysis modules:
Module Name |
Description |
---|---|
DensityPlanar |
Compute cartesian partial density profiles |
DensityCylinder |
Compute cylindrical partial densitiy profiles |
DensitySphere |
Compute spherical partial density profiles |
TemperaturePlanar |
Compute temperature profiles in a cartesian geometry |
DielectricPlanar |
Compute planar dielectric profiles |
DielectricCylinder |
Compute cylindrical dielectric profiles |
DielectricSphere |
Compute spherical dielectric profiles |
DielectricSpectrum |
Compute the linear dielectric spectrum |
Saxs |
Compute small angle X-Ray scattering intensities (SAXS) |
DiporderPlanar |
Compute planar dipolar order parameters |
DiporderCylinder |
Compute cylindrical dipolar order parameters |
DiporderSphere |
Compute spherical dipolar order parameters |
PDFPlanar |
Compute slab-wise planar 2D pair distribution functions |
PDFCylinder |
Compute cylindrical shell-wise 1D pair distribution functions |
DipoleAngle |
Compute angle timeseries of dipole moments |
KineticEnergy |
Compute the timeseries of energies |
VelocityPlanar |
Compute the velocity profile in a cartesian geometry |
VelocityCylinder |
Compute the cartesian velocity profile across a cylinder |
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
File details
Details for the file maicos-0.8.tar.gz
.
File metadata
- Download URL: maicos-0.8.tar.gz
- Upload date:
- Size: 45.2 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.18
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 15d242d638f15ab1fa8f8888df45b4f4e1a746529b33128b1555f45b839bc04f |
|
MD5 | 46ab285e5277dd0d93558c6015a2a8f3 |
|
BLAKE2b-256 | dad317f9c35132274f70ced3e80087cd8d684d8c9fdf9bd89ffc191842087aec |
File details
Details for the file maicos-0.8-cp312-cp312-win_amd64.whl
.
File metadata
- Download URL: maicos-0.8-cp312-cp312-win_amd64.whl
- Upload date:
- Size: 320.9 kB
- Tags: CPython 3.12, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.18
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 44937e3c508776d38d00a973b6f46b20914214bc53abbef60f1d6d09fb70fc8b |
|
MD5 | 8b374f227e67127ae334907e17c57c19 |
|
BLAKE2b-256 | 2a402c74175247118f3febb87bc10bdfa66204dc0f742b1f1b723ae395b170c4 |
File details
Details for the file maicos-0.8-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
.
File metadata
- Download URL: maicos-0.8-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 753.1 kB
- Tags: CPython 3.12, manylinux: glibc 2.17+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.18
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 789154186a7ac2244580abbfa52b48b65cfafe0cd8151e257ac54cc8f023bbce |
|
MD5 | 906d398962476181ee992da7f5bd8175 |
|
BLAKE2b-256 | 1d22c2105a1c05d76108ef63a30b401451bdffa121d90fb1ecab6076866560fd |
File details
Details for the file maicos-0.8-cp312-cp312-macosx_13_0_arm64.whl
.
File metadata
- Download URL: maicos-0.8-cp312-cp312-macosx_13_0_arm64.whl
- Upload date:
- Size: 324.9 kB
- Tags: CPython 3.12, macOS 13.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.18
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | d01e47ad9bf8625d76e2845e62abe72e254c62d2c609d0b45c749438bcee8965 |
|
MD5 | bbf0bbd77303725b2948e34600b71caa |
|
BLAKE2b-256 | cf49ca698f0705e797d88533be78ecec97cf85e04c346a9ee771d2f2815fe0b3 |
File details
Details for the file maicos-0.8-cp311-cp311-win_amd64.whl
.
File metadata
- Download URL: maicos-0.8-cp311-cp311-win_amd64.whl
- Upload date:
- Size: 320.6 kB
- Tags: CPython 3.11, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.18
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | c6f91169c61626563c022a1d0653443e526382648bbc323004c1f5a0c546f688 |
|
MD5 | 1feae2f79c9c7fad56bd632da0af9f33 |
|
BLAKE2b-256 | 233d27532f138a1cb4df75f4f9ebaa81b4d2f075a0923751bc94ab74d7407ec3 |
File details
Details for the file maicos-0.8-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
.
File metadata
- Download URL: maicos-0.8-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 761.3 kB
- Tags: CPython 3.11, manylinux: glibc 2.17+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.18
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | afc840931880b40974a0f410f7b6153c1f2554049af6148d301756de69265615 |
|
MD5 | b4e964184e75460a30e9981380407b29 |
|
BLAKE2b-256 | c74f9fe17a12daa5976bab936e8c46f19c318b7bbbab4097ed2576eb4c774a6d |
File details
Details for the file maicos-0.8-cp311-cp311-macosx_13_0_arm64.whl
.
File metadata
- Download URL: maicos-0.8-cp311-cp311-macosx_13_0_arm64.whl
- Upload date:
- Size: 323.8 kB
- Tags: CPython 3.11, macOS 13.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.18
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | dd949aa9041cef95c30d891006975c6041553b95226d07b67288ed9490342bd3 |
|
MD5 | 2a1e553e825cd27f5f02a730f380e0d3 |
|
BLAKE2b-256 | bdc85887a15741fd688f595eb68c1b2fbe3c09a957efc7567ba7257d406740c0 |
File details
Details for the file maicos-0.8-cp310-cp310-win_amd64.whl
.
File metadata
- Download URL: maicos-0.8-cp310-cp310-win_amd64.whl
- Upload date:
- Size: 320.4 kB
- Tags: CPython 3.10, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.18
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | ddcc2acf6bc59bc9c3a1c7fccc1db3485515be0e1c1619fd668c86e75efc1a2b |
|
MD5 | dd8d61ab8ea9115e0e1564e6ae49567f |
|
BLAKE2b-256 | 014991f02ed4a77412694900b911f16184a7d9a6c5442ee927431b356f484c80 |
File details
Details for the file maicos-0.8-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
.
File metadata
- Download URL: maicos-0.8-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 724.7 kB
- Tags: CPython 3.10, manylinux: glibc 2.17+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.18
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7272ddd1f78cef13f11452fcec5213bdbbd4354aa96d0bcf56f130d451900b79 |
|
MD5 | 88455483d46b2b64c0ef1c91b7671337 |
|
BLAKE2b-256 | 635e03bb8b31c83288078994dcaa7275a01d935b92e7e0115be710affbc7cc8d |
File details
Details for the file maicos-0.8-cp310-cp310-macosx_13_0_arm64.whl
.
File metadata
- Download URL: maicos-0.8-cp310-cp310-macosx_13_0_arm64.whl
- Upload date:
- Size: 323.7 kB
- Tags: CPython 3.10, macOS 13.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.18
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 10d958dc8805d49e7cd4dd365a03d0f51ea75943a26655f5a6410c6762246833 |
|
MD5 | 363e9611755748b584c38bab3f378d59 |
|
BLAKE2b-256 | 1f5f6474bf5f734850939898b5aeb7a4357cc1b3335a955f899e8f6aa4701511 |
File details
Details for the file maicos-0.8-cp39-cp39-win_amd64.whl
.
File metadata
- Download URL: maicos-0.8-cp39-cp39-win_amd64.whl
- Upload date:
- Size: 321.0 kB
- Tags: CPython 3.9, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.18
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 99ef9b642a7b1d90105c61adcd32d44ec28eaaf2e976161f2e38a0773204fef5 |
|
MD5 | 90440d0b194520aea4bf2b0da6a0d005 |
|
BLAKE2b-256 | 71122a5a375094cd39b52b05408f9aa176ff176532f3f45b10a0d5f05e70635a |
File details
Details for the file maicos-0.8-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
.
File metadata
- Download URL: maicos-0.8-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 727.3 kB
- Tags: CPython 3.9, manylinux: glibc 2.17+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.18
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6267b49e30aa0ea510518393fdaa27f3ede3ed2484bf5cf3f7657fe889697abe |
|
MD5 | a655bd397fa179099ee2065c1a6498e5 |
|
BLAKE2b-256 | 5ab5516909aa9816b3030e4f976833fe7caf00c5c7566f0cd1a4174b4687816c |
File details
Details for the file maicos-0.8-cp39-cp39-macosx_13_0_arm64.whl
.
File metadata
- Download URL: maicos-0.8-cp39-cp39-macosx_13_0_arm64.whl
- Upload date:
- Size: 324.3 kB
- Tags: CPython 3.9, macOS 13.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.18
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3e11670fa190b43b4c4f3bb0dc8b2266ddcae8842752f0ec5fb626e87a52bf80 |
|
MD5 | 6a2761f5b502236096ee354994b3a4b7 |
|
BLAKE2b-256 | 57bc1364d54910cfc1f52a01a50d64abf10c25b1f07734eff806e1088a91d853 |