CMIP tutorial using BioExcel Building Blocks (biobb)
This tutorial aims to illustrate the process of computing classical molecular interaction potentials from protein structures, step by step, using the BioExcel Building Blocks library (biobb). Examples shown are Molecular Interaction Potentials (MIPs) grids, protein-protein/ligand interaction potentials, and protein titration. The particular structures used are the Lysozyme protein (PDB code 1AKI), and a MD simulation of the complex formed by the SARS-CoV-2 Receptor Binding Domain and the human Angiotensin Converting Enzyme 2 (PDB code 6VW1).
The code wrapped is the Classical Molecular Interaction Potentials (CMIP) code:
Classical molecular interaction potentials: Improved setup procedure in molecular dynamics simulations of proteins. Gelpí, J.L., Kalko, S.G., Barril, X., Cirera, J., de la Cruz, X., Luque, F.J. and Orozco, M. (2001) Proteins, 45: 428-437. https://doi.org/10.1002/prot.1159
Copyright & Licensing
This software has been developed in the MMB group at the BSC & IRB for the European BioExcel, funded by the European Commission (EU H2020 823830, EU H2020 675728).
- (c) 2015-2026 Barcelona Supercomputing Center
- (c) 2015-2026 Institute for Research in Biomedicine
Licensed under the Apache License 2.0, see the file LICENSE for details.

Click and drag the diagram to pan, double click or use the controls to zoom.
Inputs
| ID | Name | Description | Type |
|---|---|---|---|
| step0_cmip_prepare_pdb_input_pdb_path | Input file | Input PDB file path. |
|
| step0_cmip_prepare_pdb_output_cmip_pdb_path | Output file | Output PDB file path. |
|
| step1_cmip_titration_output_pdb_path | Output file | Path to the output PDB file. |
|
| step1_cmip_titration_config | Config file | Configuration file for biobb_cmip.cmip_titration tool. |
|
| step2_cat_pdb_output_structure_path | Output file | Output protein file path. |
|
| step3_cmip_run_pos_output_log_path | Output file | Path to the output CMIP log file LOG. |
|
| step3_cmip_run_pos_output_cube_path | Output file | Path to the output grid file in cube format. |
|
| step3_cmip_run_pos_config | Config file | Configuration file for biobb_cmip.cmip_run tool. |
|
| step4_cmip_run_neg_output_log_path | Output file | Path to the output CMIP log file LOG. |
|
| step4_cmip_run_neg_output_cube_path | Output file | Path to the output grid file in cube format. |
|
| step4_cmip_run_neg_config | Config file | Configuration file for biobb_cmip.cmip_run tool. |
|
| step5_cmip_run_neu_output_log_path | Output file | Path to the output CMIP log file LOG. |
|
| step5_cmip_run_neu_output_cube_path | Output file | Path to the output grid file in cube format. |
|
| step5_cmip_run_neu_config | Config file | Configuration file for biobb_cmip.cmip_run tool. |
|
| step6_remove_pdb_water_input_pdb_path | Input file | Input PDB file path. |
|
| step6_remove_pdb_water_output_pdb_path | Output file | Output PDB file path. |
|
| step7_extract_heteroatoms_output_heteroatom_path | Output file | Output heteroatom file path. |
|
| step7_extract_heteroatoms_config | Config file | Configuration file for biobb_structure_utils.extract_heteroatoms tool. |
|
| step8_reduce_add_hydrogens_output_path | Output file | Path to the output file. |
|
| step9_acpype_params_ac_output_path_inpcrd | Output file | Path to the INPCRD output file. |
|
| step9_acpype_params_ac_output_path_frcmod | Output file | Path to the FRCMOD output file. |
|
| step9_acpype_params_ac_output_path_lib | Output file | Path to the LIB output file. |
|
| step9_acpype_params_ac_output_path_prmtop | Output file | Path to the PRMTOP output file. |
|
| step9_acpype_params_ac_config | Config file | Configuration file for biobb_chemistry.acpype_params_ac tool. |
|
| step10_leap_gen_top_output_pdb_path | Output file | Output 3D structure PDB file matching the topology file. |
|
| step10_leap_gen_top_output_top_path | Output file | Output topology file (AMBER ParmTop). |
|
| step10_leap_gen_top_output_crd_path | Output file | Output coordinates file (AMBER crd). |
|
| step10_leap_gen_top_config | Config file | Configuration file for biobb_amber.leap_gen_top tool. |
|
| step11_sander_mdrun_output_traj_path | Output file | Output trajectory file. |
|
| step11_sander_mdrun_output_rst_path | Output file | Output restart file. |
|
| step11_sander_mdrun_output_log_path | Output file | Output log file. |
|
| step11_sander_mdrun_config | Config file | Configuration file for biobb_amber.sander_mdrun tool. |
|
| step12_amber_to_pdb_output_pdb_path | Output file | Structure PDB file. |
|
| step13_cmip_prepare_structure_output_cmip_pdb_path | Output file | Path to the output PDB file. |
|
| step14_remove_ligand_output_structure_path | Output file | Output structure file path. |
|
| step14_remove_ligand_config | Config file | Configuration file for biobb_structure_utils.remove_ligand tool. |
|
| step15_cmip_ignore_residues_output_cmip_pdb_path | Output file | Output PDB file path. |
|
| step15_cmip_ignore_residues_config | Config file | Configuration file for biobb_cmip.cmip_ignore_residues tool. |
|
| step16_cmip_run_int_en_output_log_path | Output file | Path to the output CMIP log file LOG. |
|
| step16_cmip_run_int_en_output_byat_path | Output file | Path to the output atom by atom energy file. |
|
| step16_cmip_run_int_en_config | Config file | Configuration file for biobb_cmip.cmip_run tool. |
|
| step17_cmip_prepare_structure_input_pdb_path | Input file | Path to the input PDB file. |
|
| step17_cmip_prepare_structure_input_topology_path | Input file | Path to the input topology path. |
|
| step17_cmip_prepare_structure_output_cmip_pdb_path | Output file | Path to the output PDB file. |
|
| step18_extract_chain_a_output_structure_path | Output file | Output structure file path. |
|
| step18_extract_chain_a_config | Config file | Configuration file for biobb_structure_utils.extract_chain tool. |
|
| step19_extract_chain_b_output_structure_path | Output file | Output structure file path. |
|
| step19_extract_chain_b_config | Config file | Configuration file for biobb_structure_utils.extract_chain tool. |
|
| step20_cmip_run_rbd_output_log_path | Output file | Path to the output CMIP log file LOG. |
|
| step20_cmip_run_rbd_output_json_box_path | Output file | Path to the output CMIP box in JSON format. |
|
| step20_cmip_run_rbd_config | Config file | Configuration file for biobb_cmip.cmip_run tool. |
|
| step21_cmip_run_hace2_output_log_path | Output file | Path to the output CMIP log file LOG. |
|
| step21_cmip_run_hace2_output_json_box_path | Output file | Path to the output CMIP box in JSON format. |
|
| step21_cmip_run_hace2_config | Config file | Configuration file for biobb_cmip.cmip_run tool. |
|
| step22_cmip_run_rbd_hace2_output_log_path | Output file | Path to the output CMIP log file LOG. |
|
| step22_cmip_run_rbd_hace2_output_json_box_path | Output file | Path to the output CMIP box in JSON format. |
|
| step22_cmip_run_rbd_hace2_config | Config file | Configuration file for biobb_cmip.cmip_run tool. |
|
| step23_cmip_ignore_residues_rbd_output_cmip_pdb_path | Output file | Output PDB file path. |
|
| step23_cmip_ignore_residues_rbd_config | Config file | Configuration file for biobb_cmip.cmip_ignore_residues tool. |
|
| step24_cmip_run_prot_prot_output_json_box_path | Output file | Path to the output CMIP box in JSON format. |
|
| step24_cmip_run_prot_prot_output_json_external_box_path | Output file | Path to the output external CMIP box in JSON format. |
|
| step24_cmip_run_prot_prot_output_log_path | Output file | Path to the output CMIP log file LOG. |
|
| step24_cmip_run_prot_prot_output_byat_path | Output file | Path to the output atom by atom energy file. |
|
| step24_cmip_run_prot_prot_config | Config file | Configuration file for biobb_cmip.cmip_run tool. |
|
| step25_cmip_ignore_residues_hace2_output_cmip_pdb_path | Output file | Output PDB file path. |
|
| step25_cmip_ignore_residues_hace2_config | Config file | Configuration file for biobb_cmip.cmip_ignore_residues tool. |
|
| step26_cmip_run_complex_output_json_box_path | Output file | Path to the output CMIP box in JSON format. |
|
| step26_cmip_run_complex_output_json_external_box_path | Output file | Path to the output external CMIP box in JSON format. |
|
| step26_cmip_run_complex_output_log_path | Output file | Path to the output CMIP log file LOG. |
|
| step26_cmip_run_complex_output_byat_path | Output file | Path to the output atom by atom energy file. |
|
| step26_cmip_run_complex_config | Config file | Configuration file for biobb_cmip.cmip_run tool. |
|
Steps
| ID | Name | Description |
|---|---|---|
| step0_cmip_prepare_pdb | cmip_prepare_pdb | Creates a CMIP suitable PDB from an standar PDB file |
| step1_cmip_titration | cmip_titration | CMIP cmip module compute classical molecular interaction potentials. |
| step2_cat_pdb | cat_pdb | Class to concat two PDB structures in a single PDB file. |
| step3_cmip_run_pos | cmip_run | CMIP cmip module compute classical molecular interaction potentials. |
| step4_cmip_run_neg | cmip_run | CMIP cmip module compute classical molecular interaction potentials. |
| step5_cmip_run_neu | cmip_run | CMIP cmip module compute classical molecular interaction potentials. |
| step6_remove_pdb_water | remove_pdb_water | This class is a wrapper of the Structure Checking tool to remove water molecules from PDB 3D structures. |
| step7_extract_heteroatoms | extract_heteroatoms | Class to extract hetero-atoms from a 3D structure. |
| step8_reduce_add_hydrogens | reduce_add_hydrogens | Adds hydrogen atoms to small molecules. |
| step9_acpype_params_ac | acpype_params_ac | Small molecule parameterization for AMBER MD package. |
| step10_leap_gen_top | leap_gen_top | Generates a MD topology from a molecule structure using tLeap tool from the AmberTools MD package |
| step11_sander_mdrun | sander_mdrun | Runs energy minimization, molecular dynamics, and NMR refinements using sander tool from the AmberTools MD package |
| step12_amber_to_pdb | amber_to_pdb | Generates a PDB structure from AMBER topology (parmtop) and coordinates (crd) files, using the ambpdb tool from the AmberTools MD package |
| step13_cmip_prepare_structure | cmip_prepare_structure | Creates a CMIP suitable PDB from an standar structure file |
| step14_remove_ligand | remove_ligand | Class to remove the selected ligand atoms from a 3D structure. |
| step15_cmip_ignore_residues | cmip_ignore_residues | Mark residues which charges will be ignored in the CMIP potential calculations. |
| step16_cmip_run_int_en | cmip_run | CMIP cmip module compute classical molecular interaction potentials. |
| step17_cmip_prepare_structure | cmip_prepare_structure | Creates a CMIP suitable PDB from an standar structure file |
| step18_extract_chain_a | extract_chain | This class is a wrapper of the Structure Checking tool to extract a chain from a 3D structure. |
| step19_extract_chain_b | extract_chain | This class is a wrapper of the Structure Checking tool to extract a chain from a 3D structure. |
| step20_cmip_run_rbd | cmip_run | CMIP cmip module compute classical molecular interaction potentials. |
| step21_cmip_run_hace2 | cmip_run | CMIP cmip module compute classical molecular interaction potentials. |
| step22_cmip_run_rbd_hace2 | cmip_run | CMIP cmip module compute classical molecular interaction potentials. |
| step23_cmip_ignore_residues_rbd | cmip_ignore_residues | Mark residues which charges will be ignored in the CMIP potential calculations. |
| step24_cmip_run_prot_prot | cmip_run | CMIP cmip module compute classical molecular interaction potentials. |
| step25_cmip_ignore_residues_hace2 | cmip_ignore_residues | Mark residues which charges will be ignored in the CMIP potential calculations. |
| step26_cmip_run_complex | cmip_run | CMIP cmip module compute classical molecular interaction potentials. |
Outputs
| ID | Name | Description | Type |
|---|---|---|---|
| step0_cmip_prepare_pdb_out1 | output_cmip_pdb_path | Output PDB file path. |
|
| step1_cmip_titration_out1 | output_pdb_path | Path to the output PDB file. |
|
| step2_cat_pdb_out1 | output_structure_path | Output protein file path. |
|
| step3_cmip_run_pos_out1 | output_log_path | Path to the output CMIP log file LOG. |
|
| step3_cmip_run_pos_out2 | output_cube_path | Path to the output grid file in cube format. |
|
| step4_cmip_run_neg_out1 | output_log_path | Path to the output CMIP log file LOG. |
|
| step4_cmip_run_neg_out2 | output_cube_path | Path to the output grid file in cube format. |
|
| step5_cmip_run_neu_out1 | output_log_path | Path to the output CMIP log file LOG. |
|
| step5_cmip_run_neu_out2 | output_cube_path | Path to the output grid file in cube format. |
|
| step6_remove_pdb_water_out1 | output_pdb_path | Output PDB file path. |
|
| step7_extract_heteroatoms_out1 | output_heteroatom_path | Output heteroatom file path. |
|
| step8_reduce_add_hydrogens_out1 | output_path | Path to the output file. |
|
| step9_acpype_params_ac_out1 | output_path_inpcrd | Path to the INPCRD output file. |
|
| step9_acpype_params_ac_out2 | output_path_frcmod | Path to the FRCMOD output file. |
|
| step9_acpype_params_ac_out3 | output_path_lib | Path to the LIB output file. |
|
| step9_acpype_params_ac_out4 | output_path_prmtop | Path to the PRMTOP output file. |
|
| step10_leap_gen_top_out1 | output_pdb_path | Output 3D structure PDB file matching the topology file. |
|
| step10_leap_gen_top_out2 | output_top_path | Output topology file (AMBER ParmTop). |
|
| step10_leap_gen_top_out3 | output_crd_path | Output coordinates file (AMBER crd). |
|
| step11_sander_mdrun_out1 | output_traj_path | Output trajectory file. |
|
| step11_sander_mdrun_out2 | output_rst_path | Output restart file. |
|
| step11_sander_mdrun_out3 | output_log_path | Output log file. |
|
| step12_amber_to_pdb_out1 | output_pdb_path | Structure PDB file. |
|
| step13_cmip_prepare_structure_out1 | output_cmip_pdb_path | Path to the output PDB file. |
|
| step14_remove_ligand_out1 | output_structure_path | Output structure file path. |
|
| step15_cmip_ignore_residues_out1 | output_cmip_pdb_path | Output PDB file path. |
|
| step16_cmip_run_int_en_out1 | output_log_path | Path to the output CMIP log file LOG. |
|
| step16_cmip_run_int_en_out2 | output_byat_path | Path to the output atom by atom energy file. |
|
| step17_cmip_prepare_structure_out1 | output_cmip_pdb_path | Path to the output PDB file. |
|
| step18_extract_chain_a_out1 | output_structure_path | Output structure file path. |
|
| step19_extract_chain_b_out1 | output_structure_path | Output structure file path. |
|
| step20_cmip_run_rbd_out1 | output_log_path | Path to the output CMIP log file LOG. |
|
| step20_cmip_run_rbd_out2 | output_json_box_path | Path to the output CMIP box in JSON format. |
|
| step21_cmip_run_hace2_out1 | output_log_path | Path to the output CMIP log file LOG. |
|
| step21_cmip_run_hace2_out2 | output_json_box_path | Path to the output CMIP box in JSON format. |
|
| step22_cmip_run_rbd_hace2_out1 | output_log_path | Path to the output CMIP log file LOG. |
|
| step22_cmip_run_rbd_hace2_out2 | output_json_box_path | Path to the output CMIP box in JSON format. |
|
| step23_cmip_ignore_residues_rbd_out1 | output_cmip_pdb_path | Output PDB file path. |
|
| step24_cmip_run_prot_prot_out1 | output_json_box_path | Path to the output CMIP box in JSON format. |
|
| step24_cmip_run_prot_prot_out2 | output_json_external_box_path | Path to the output external CMIP box in JSON format. |
|
| step24_cmip_run_prot_prot_out3 | output_log_path | Path to the output CMIP log file LOG. |
|
| step24_cmip_run_prot_prot_out4 | output_byat_path | Path to the output atom by atom energy file. |
|
| step25_cmip_ignore_residues_hace2_out1 | output_cmip_pdb_path | Output PDB file path. |
|
| step26_cmip_run_complex_out1 | output_json_box_path | Path to the output CMIP box in JSON format. |
|
| step26_cmip_run_complex_out2 | output_json_external_box_path | Path to the output external CMIP box in JSON format. |
|
| step26_cmip_run_complex_out3 | output_log_path | Path to the output CMIP log file LOG. |
|
| step26_cmip_run_complex_out4 | output_byat_path | Path to the output atom by atom energy file. |
|
Version History
Version 1 (earliest) Created 1st Apr 2026 at 09:17 by Genís Bayarri
Initial commit
Frozen
Version-1
5199feb
Creators and SubmitterCreators
Submitter
Views: 222 Downloads: 63
Created: 1st Apr 2026 at 09:17
TagsThis item has not yet been tagged.
AttributionsNone
View on GitHub
https://orcid.org/0000-0003-0513-0288