Skip to content

RadonPy is a Python library to automate physical property calculations for polymer informatics.

License

Notifications You must be signed in to change notification settings

RadonPy/RadonPy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

logo

Overview

RadonPy is the first open-source Python library for fully automated calculation for a comprehensive set of polymer properties, using all-atom classical MD simulations. For a given polymer repeating unit with its chemical structure, the entire process of the MD simulation can be carried out fully automatically, including molecular modelling, equilibrium and non-equilibrium MD simulations, automatic determination of the completion of equilibration, scheduling of restarts in case of failure to converge, and property calculations in the post-process step. In this release, the library comprises the calculation of 15 properties at the amorphous state.

Requirement

  • Python 3.7, 3.8, 3.9, 3.10, 3.11, 3.12
  • LAMMPS >= 3Mar20
  • rdkit >= 2020.03
  • psi4 >= 1.5
  • resp
  • dftd3
  • mdtraj >= 1.9
  • scipy
  • matplotlib

Installation and usage

User manual and conda packages are currently in preparation.

PyPI package is available, but Psi4 can not be installed by pip install.

PDF file of RadonPy tutorial is available.

Installation for conda (for Psi4 >= 1.8):

  1. Create conda environment
conda create -n radonpy python=3.11
conda activate radonpy
  1. Installation of requirement packages by conda
conda install -c conda-forge/label/libint_dev -c conda-forge -c psi4 rdkit psi4 resp mdtraj matplotlib
  1. Installation of LAMMPS by conda
conda install -c conda-forge lammps

or manually build from source of LAMMPS official site. In this case, the environment variable must be set:

export LAMMPS_EXEC=<Path-to-LAMMPS-binary>
  1. Installation of RadonPy
pip install radonpy-pypi

Installation for conda (for Psi4 <= 1.7):

  1. Create conda environment
conda create -n radonpy python=3.9
conda activate radonpy
  1. Installation of requirement packages by conda
conda install -c psi4 -c conda-forge rdkit psi4 resp mdtraj matplotlib
  1. Installation of LAMMPS by conda
conda install -c conda-forge lammps

or manually build from source of LAMMPS official site. In this case, the environment variable must be set:

export LAMMPS_EXEC=<Path-to-LAMMPS-binary>
  1. Installation of RadonPy
pip install radonpy-pypi

Installation from PyPI

RadonPy can be also installed by using only pip install. However, this intallation method can not install Psi4.

  • Without LAMMPS installation
pip install radonpy-pypi

This is minimal installation of RadonPy. Many functions, such as polymer structure builder, force field assignment, force field descriptor, and tools for polymer informatics, are available, but automated DFT and MD simulations are not available.

  • With LAMMPS installation
pip install radonpy-pypi[lammps]

MD simulations are available in this installation, but DFT calculations (conformation search, cherge calculation, and electronic property calculation) are not available.

Features

  • Fully automated all-atom classical MD calculation for polymeric materials
    • Conformation search
    • Cherge calculation (RESP, ESP, Mulliken, Lowdin, Gasteiger)
    • Electronic property calculation (HOMO, LUMO, dipole moment, polarizability)
    • Generation of a polymer chain
      • Homopolymer
      • Alternating copolymer
      • Random copolymer
      • Block copolymer
    • Generation of a simulation cell
      • Amorphous
      • Polymer mixture
      • Polymer solution
      • Crystalline polymer
      • Oriented structure
    • Run for equilibration MD
    • Checking archivement of equilibrium
    • Run for non-equilibrium MD (NEMD)
    • Calculation of physical properties from the MD calculation results
      • Thermal conductivity
      • Thermal diffusivity
      • Density
      • Cp
      • Cv
      • Linear expansion coefficient
      • Volumetric expansion coefficient
      • Compressibility
      • Bulk modulus
      • Isentropic compressibility
      • Isentropic bulk modulus
      • Static dielectric constant
      • Refractive index
      • Radius of gyration
      • End-to-end distance
      • Nematic order parameter
    • Using LAMMPS and Psi4 as calculation engines of MD and DFT calculations
  • Implementation of add-on like presets to allow for proper and easy execution of polymer MD calculations
    • Equilibration MD
    • Calculation of thermal conductivity with NEMD
  • Easy installation
    • Only using open-source software
  • Tools for polymer informatics
    • Force field descriptor (How to use)
    • Generator of macrocyclic oligomer for descriptor construction of polymers
    • Full and substruct match function for polymer SMILES
    • Extractor of mainchain in a polymer backbone
    • Monomerization of oligomer SMILES
    • Emulator of polymer classification in PoLyInfo

MD calculated data

Publications

  1. Y. Hayashi, J. Shiomi, J. Morikawa, R. Yoshida, "RadonPy: Automated Physical Property Calculation using All-atom Classical Molecular Dynamics Simulations for Polymer Informatics," npj Comput. Mater., 8:222 (2022) [Link]
  2. M. Kusaba, Y. Hayashi, C. Liu, A. Wakiuchi, R. Yoshida, "Representation of materials by kernel mean embedding", Phys. Rev. B, 108:134107 (2023)[Link]

Contributors

  • Yoshihiro Hayashi (The Institute of Statistical Mathematics)

Related projects

  • XenonPy (Machine learning tools for materials informatics) [Link]
  • SMiPoly (Polymerization rule-based virtual polymer generator) [Link]

Acknowledgements

The development of RadonPy was financially supported by the following grants

  • Japan Science and Technology Agency (JST) CREST (Grant Number: JPMJCR19I3)
  • Ministry of Education, Culture, Sports, Science and Technology (MEXT) as “Program for Promoting Researches on the Supercomputer Fugaku” (Project ID: hp210264)
  • The Japan Society for the Promotion of Science (JSPS) as the Grant-in-Aid for Scientific Research (A) (Grant Number: 19H01132)
  • JSPS as the Grant-in-Aid for Scientific Research (C) (Grant Number: 22K11949)

The numerical calculations were conducted on the following supercomputer systems

  • Fugaku at the RIKEN Center for Computational Science, Kobe, Japan (Project ID: hp210264, hp210213)
  • The supercomputer at the Research Center for Computational Science, Okazaki, Japan (Project ID: 21-IMS-C126, 22-IMS-C125, 23-IMS-C113)
  • The supercomputer Ohtaka at the Supercomputer Center, the Institute for Solid State Physics, the University of Tokyo, Tokyo, Japan
  • The supercomputer TSUBAME3.0 at the Tokyo Institute of Technology, Tokyo, Japan
  • The supercomputer ABCI at the National Institute of Advanced Industrial Science and Technology, Tsukuba, Japan

Copyright and licence

©Copyright 2023 The RadonPy developers, all rights reserved. Released under the BSD-3 license.

Radon_ikaho