selection.assess() — assess a model selection

assess(assessor, output='SHORT NO_REPORT', **vars)

Output:

score

This command assesses the quality of the selected atoms in the model using the provided assessor object. Typically this is used for SOAP scoring, with assessor being soap_loop.Scorer() or soap_protein_od.Scorer().

Assessment uses the standard MODELLER energy function, so any of the arguments accepted by selection.energy() can also be used here. See selection.assess_dope() for more details on this and schedule_scale.

Any of the assessor objects accepted by this function can also be used for automatic assessment of each automodel or loopmodel model; see Section 2.2.3 or Section 2.3.3 for examples.

Example: examples/assessment/assess_soap_protein.py

# Example for: selection.assess(), soap_protein_od.Scorer()

from modeller import *
from modeller.scripts import complete_pdb
from modeller import soap_protein_od

env = environ()
env.libs.topology.read(file='$(LIB)/top_heav.lib')
env.libs.parameters.read(file='$(LIB)/par.lib')

# Set up SOAP-Protein-OD scoring (note: if assessing multiple models, it is
# best to create 'sp' just once and keep it around, since reading in the
# potential from disk can take a long time).
sp = soap_protein_od.Scorer()

# Read a model previously generated by Modeller's automodel class
mdl = complete_pdb(env, '../atom_files/1fdx.B99990001.pdb')

# Select all atoms in the first chain
atmsel = selection(mdl.chains[0])

# Assess with the above Scorer
try:
    score = atmsel.assess(sp)
except ModellerError:
    print("The SOAP-Protein-OD library file is not included with MODELLER.")
    print("Please get it from https://salilab.org/SOAP/.")