Skip to content
/ peas Public

A user-friendly application for precise conformation sampling

License

Notifications You must be signed in to change notification settings

mitkeng/peas

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

66 Commits
 
 
 
 
 
 

Repository files navigation

python user user user

PEÅS: An Application For Precision Ensemble Generation


focus


Introduction

PEÅS (Precise Ensemble Autonomous Sampling) is an exceptionally user-friendly python based application for generating experimentally relevant gas phase chemical structures. PEÅS integrates and modulizes two in-house machine learning programs (S∈∈R) (State Ensemble Energy Recognition) and (CCSF) (Collision Cross Section Focusing) that function as a charge site (protonation or deprotonation) predictor and an empirical conformation space filter, respectively. Both programs were trained on datasets consisting of DFT (Density Functional Theory) ground truth systems, which experimental validities were assessed using ion-mobility mass spectrometry collision cross section. A third module in PEÅS employs Confab for conformation generation, as required for ensemble generation.

The resulting ensemble produced by PEÅS is ultra filtered in conformational space and energy.

Hallmark Steps

Screenshot 2024-11-16 at 2 50 08 PM

User Brief

To initiate, in the Seed Structure and Charge Selection section, a SMILE or an XYZ format file is applicable. For the SMILE option, enter an ID or name in the molecule_name field along with a SMILE string. For the XYZ file option, upload or drop the file into the local directory. Next, fill in the folder_name field (this is where the system input will be temporarily stored) and select a desired ion species from the charge_mode options (i.e., [M-H]- or [M+H]+). Finally, in the CCS Focusing section, enter a reference CCS value in the Experimental_CCS field.

In completion of job, ensemble(s) generated will be converted to a zip file and automatically downloaded. Additionally, accessory files containing run details and preliminary results are also available for user's discretion.

Application Benefits

  • Improves modeling success
  • Limited user-intervention
  • No structural artifact
  • Reasonable turnaround time
  • Reduces false positives
  • Stepwise preliminary results
  • User-friendly interface
  • Work volume reduction

Limitations

Currently, PEÅS only generates a conformation ensemble exclusively for protonated, [M+H]+, or singly deprotonated, [M-H]-, molecular ion species. Protonation or deprotonation is assigned to either a nitrogen atom or an oxygen atom, thus, all other atom types are not supported. Refer to the documentations for the programs (i.e., CCSF, Confab, or S∈∈R) implemented in PEÅS for additional carryover limitations.

Accessibility

Open In Colab access to the PEÅS platform is pending publication.

Acknowledgement

  • Merz research group

  • Quantum mechanical calculations and data used in building the models that are modulized in PEÅS were organically generated with the aid computational resources and services provided by the Institute for Cyber-Enabled Research (ICER) at Michigan State University.