schrodinger.protein.assignment module

Module for optimizing hydroxyl, thiol and water orientiations, Chi-flips of asparagine, glutamine and histidine, and protonation states of aspartic acid, glutamic acid, and histidine.

Usage: ProtAssign(st)

Copyright Schrodinger, LLC. All rights reserved.

exception schrodinger.protein.assignment.PropKaException(value)[source]

Bases: Exception

__init__(value)[source]

Initialize self. See help(type(self)) for accurate signature.

args
with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

schrodinger.protein.assignment.report(message_level=1, message='')[source]
schrodinger.protein.assignment.measure(ct, atom1=None, atom2=None, atom3=None, atom4=None, use_xtal=False, max_dist=10.0)[source]
schrodinger.protein.assignment.calculate_interaction_matrix(ct, iatoms, distance, use_xtal=False)[source]

Create an interaction matrix based on the changeable_index atom property

Parameters
  • ct (structure.Structure) – Structure with annotated atoms having set the i_pa_changeable_index corresponding the the index of the changeable

  • iatoms (List[int]) – List of atom indices which take part in interaction

  • distance (float) – Max distance between interacting atoms

  • use_xtal – Take into account crystal symmetry mates

  • use_xtal – bool

Returns

interaction matrix allowing double indexing: interact[i][j]

Return type

defaultdict(lambda: defaultdict(bool))

schrodinger.protein.assignment.annotate_structure_interactors(ct, acceptors, donors, clashers)[source]

Set atom property for each interactor class

Parameters
  • ct (Structure) – Structure to annotate

  • acceptors (List[int]) – List of acceptor atom indices

  • donors (List[tuple[int, int]]) – List of donor pair atom indices

  • clashers (List[int]) – List of clasher atom indices

Returns

None but sets atom properties

Return type

NoneType

schrodinger.protein.assignment.check_residue_flip_state(res: schrodinger.structure._structure._Residue) → tuple[source]

Determine whether a residue cannot be flipped, is, or is not flipped.

Parameters

res – a protein residue

Returns

a tuple of (state, msg), where state describes whether the residue is flipped (True), is not flipped (False), or cannot be flipped (None); if None, msg will contain an explanation

Return type

tuple[bool or NoneType, str]

schrodinger.protein.assignment.get_residue_flip_state(res: schrodinger.structure._structure._Residue) → Optional[bool][source]

Return the flip state of a protein residue.

A truncated version of check_residue_flip_state().

Parameters

res – a protein residue

Returns

the flip state of a residue

schrodinger.protein.assignment.get_residue_string(residue: schrodinger.structure._structure._Residue) → str[source]

Return a string describing a residue.

The string will match the format

<chain>:<residue PDB code> <residue number>[<insertion code>]

Parameters

residue – a protein residue

Returns

a string describing the residue

schrodinger.protein.assignment.get_heavy_neighbors(atom: schrodinger.structure._structure._StructureAtom) → list[source]
Parameters

atom – an atom

Returns

a list of heavy (non-H) atoms covalently bound to atom

Return type

list[structure._StructureAtom]

class schrodinger.protein.assignment.WaterStateEnumerator(ct, oxygen, acceptors, donors)[source]

Bases: object

Enumerate discrete water states that are hydrogen bonding with nearby acceptors and donors

The goal is to sample likely states while also limiting the number of states as solving the combinatorial problem gets harder with more and more states.

OH_LENGTH = 1.0
HOH_ANGLE = 109.5
MIN_HYDROGEN_NONSTATIC_DONOR_DISTANCE = 2.5
__init__(ct, oxygen, acceptors, donors)[source]
Parameters
  • ct (Structure) – Annotated structure with donor/acceptor and static flags.

  • oxygen (_StructureAtom) – Oxygen atom of water

  • acceptors (List[int]) – List of acceptor atom indices

  • donors (List[Tuple[int, int]]) – List of donor atom indices

enumerate_acceptor_acceptor_states()[source]

Enumerate states where water is donating to two acceptors at the same time

Returns

List of water states

Return type

List[_WaterState]

enumerate_donor_donor_states()[source]

Enumerate states where water is accepting from two donors at the same time

Returns

List of water states

Return type

List[_WaterState]

enumerate_acceptor_states()[source]

Enumerate states where water is donating to a single acceptor

Returns

List of water states

Return type

List[_WaterState]

enumerate_donor_states()[source]

Enumerate states where water is accepting from a single donor

Returns

List of water states

Return type

List[_WaterState]

rotate_hydrogens_along_axis(axis, angle)[source]

Rotate the water hydrogens along an axis by an angle. Does not return anything but moves hydrogens in place.

Parameters
  • axis (3 floats) – Axis along to rotate to

  • angle (float) – Angle to rotate in degrees

class schrodinger.protein.assignment.ProtAssign(ct, interactive=False, do_flips=True, asl='', noprot_asl='', atoms=[], use_xtal=False, torsion_penalty=False, sample_waters=True, sample_acids=True, freeze_existing=False, include_initial=False, max_comb=10000, num_sequential_cycles=30, max_cluster_size=None, logging_level=1, quiet_flag=False, debug_flag=False, add_labels=True, label_pkas=False, pH='neutral', use_propka=True, propka_pH=7.0, user_states=[], minimize=False)[source]

Bases: object

class changeable(ct, iatom)[source]

Bases: object

asl = 'none'
max_hbond_distance = 3.5
hbond_min_angle = 150.0
hbond_heavy_min_angle = 80.0
hbond_heavy_max_angle = 140.0
__init__(ct, iatom)[source]

Initialize self. See help(type(self)) for accurate signature.

pre_treat_1(ct)[source]
pre_treat_2(ct)[source]
pre_treat(ct)[source]
enumerate_states(ct, acceptors, donors, pH, do_flips=True, include_initial=False)[source]
lock_protonation()[source]
add_current_to_states(ct)[source]
assign_state(ct, istate, add_labels=True, label_pkas=False, state_gap=None, verbose=False)[source]
assign_state_gap(atom, state_gaps, report_gaps=True)[source]

Write the Gap in energy between the lowest energy state and the state with different protonation states or heavy atom positions to the output ct :param atom: The atom that should have properties written to it :type atom:structure.StructureAtom :param state_gaps: The energy gaps between states for a given

changeable position.

Parameters

report_gaps (Boolean) – Whether to report the gaps to the log file as well

update_atom_indices(ct, new_indices)[source]
get_new_index(ct, atom_index, new_indices)[source]
get_view_atoms()[source]
get_residue_name(ct, iatom)[source]
get_atom_name(ct, iatom)[source]
swap_atoms(ct, atom1, atom2)[source]
get_penalty(istate)[source]
get_adjustable_atoms()[source]
change_pka(pka, propka_pH)[source]
get_dihedral_atoms(ct, h)[source]
get_close_interactors(ct, dcell)[source]

Return acceptors, donors and clashers that are close to this changeable heavy atoms.

Parameters
  • ct (Structure) – Structure with annotated atoms signfying interaction class

  • dcell (DistanceCell) – Distance cell to query for neighboring atoms

Returns

List of acceptors, donor pairs, and clashers atom indices

Return type

tuple[list[int], list[tuple[int, int]], list[int]]

class amide_changeable(ct, iatom)[source]

Bases: schrodinger.protein.assignment.ProtAssign.changeable

This is the primary amide -NH2 group of ASN and GLN residues.

asl = '((res.ptype "ASN " AND atom.ptype " CG ") OR (res.ptype "GLN " AND atom.ptype " CD "))'
__init__(ct, iatom)[source]

Initialize self. See help(type(self)) for accurate signature.

pre_treat_1(ct)[source]
pre_treat_2(ct)[source]
enumerate_states(ct, acceptors, donors, pH, do_flips=True, include_initial=False)[source]
assign_state(ct, istate, add_labels=True, label_pkas=False, state_gaps=None, verbose=False)[source]
update_atom_indices(ct, new_indices)[source]
get_heavies()[source]
get_state_sites(ct, istate)[source]
get_view_atoms()[source]
get_penalty(istate)[source]
get_adjustable_atoms()[source]
add_current_to_states(ct)
assign_state_gap(atom, state_gaps, report_gaps=True)

Write the Gap in energy between the lowest energy state and the state with different protonation states or heavy atom positions to the output ct :param atom: The atom that should have properties written to it :type atom:structure.StructureAtom :param state_gaps: The energy gaps between states for a given

changeable position.

Parameters

report_gaps (Boolean) – Whether to report the gaps to the log file as well

change_pka(pka, propka_pH)
get_atom_name(ct, iatom)
get_close_interactors(ct, dcell)

Return acceptors, donors and clashers that are close to this changeable heavy atoms.

Parameters
  • ct (Structure) – Structure with annotated atoms signfying interaction class

  • dcell (DistanceCell) – Distance cell to query for neighboring atoms

Returns

List of acceptors, donor pairs, and clashers atom indices

Return type

tuple[list[int], list[tuple[int, int]], list[int]]

get_dihedral_atoms(ct, h)
get_new_index(ct, atom_index, new_indices)
get_residue_name(ct, iatom)
hbond_heavy_max_angle = 140.0
hbond_heavy_min_angle = 80.0
hbond_min_angle = 150.0
lock_protonation()
max_hbond_distance = 3.5
pre_treat(ct)
swap_atoms(ct, atom1, atom2)
class histidine_changeable(ct, iatom)[source]

Bases: schrodinger.protein.assignment.ProtAssign.changeable

Imidazole group of Histidine residues.

asl = '((res.ptype "HIS ","HID ","HIE ","HIP ")) AND ((atom.ptype " CG "))'
__init__(ct, iatom)[source]

Initialize self. See help(type(self)) for accurate signature.

pre_treat_1(ct)[source]
pre_treat_2(ct)[source]
enumerate_states(ct, acceptors, donors, pH, do_flips=True, include_initial=False)[source]
lock_protonation()[source]
assign_state(ct, istate, add_labels=True, label_pkas=False, state_gaps=None, verbose=False)[source]
update_atom_indices(ct, new_indices)[source]
get_heavies()[source]
get_state_sites(ct, istate)[source]
get_view_atoms()[source]
get_penalty(istate)[source]
get_adjustable_atoms()[source]
change_pka(pka, propka_pH)[source]
add_current_to_states(ct)
assign_state_gap(atom, state_gaps, report_gaps=True)

Write the Gap in energy between the lowest energy state and the state with different protonation states or heavy atom positions to the output ct :param atom: The atom that should have properties written to it :type atom:structure.StructureAtom :param state_gaps: The energy gaps between states for a given

changeable position.

Parameters

report_gaps (Boolean) – Whether to report the gaps to the log file as well

get_atom_name(ct, iatom)
get_close_interactors(ct, dcell)

Return acceptors, donors and clashers that are close to this changeable heavy atoms.

Parameters
  • ct (Structure) – Structure with annotated atoms signfying interaction class

  • dcell (DistanceCell) – Distance cell to query for neighboring atoms

Returns

List of acceptors, donor pairs, and clashers atom indices

Return type

tuple[list[int], list[tuple[int, int]], list[int]]

get_dihedral_atoms(ct, h)
get_new_index(ct, atom_index, new_indices)
get_residue_name(ct, iatom)
hbond_heavy_max_angle = 140.0
hbond_heavy_min_angle = 80.0
hbond_min_angle = 150.0
max_hbond_distance = 3.5
pre_treat(ct)
swap_atoms(ct, atom1, atom2)
class carboxyl_changeable(ct, iatom)[source]

Bases: schrodinger.protein.assignment.ProtAssign.changeable

asl = '(res.ptype "ASP ","ASH " AND atom.ptype " CG ") OR (res.ptype "GLU ","GLH " AND atom.ptype " CD ")'
__init__(ct, iatom)[source]

Initialize self. See help(type(self)) for accurate signature.

pre_treat_1(ct)[source]
pre_treat_2(ct)[source]
enumerate_states(ct, acceptors, donors, pH, do_flips=True, include_initial=False)[source]
lock_protonation()[source]
assign_state(ct, istate, add_labels=True, label_pkas=False, state_gaps=None, verbose=False)[source]
update_atom_indices(ct, new_indices)[source]
get_heavies()[source]
get_state_sites(ct, istate)[source]
get_view_atoms()[source]
get_penalty(istate)[source]
get_adjustable_atoms()[source]
change_pka(pka, propka_pH)[source]
add_current_to_states(ct)
assign_state_gap(atom, state_gaps, report_gaps=True)

Write the Gap in energy between the lowest energy state and the state with different protonation states or heavy atom positions to the output ct :param atom: The atom that should have properties written to it :type atom:structure.StructureAtom :param state_gaps: The energy gaps between states for a given

changeable position.

Parameters

report_gaps (Boolean) – Whether to report the gaps to the log file as well

get_atom_name(ct, iatom)
get_close_interactors(ct, dcell)

Return acceptors, donors and clashers that are close to this changeable heavy atoms.

Parameters
  • ct (Structure) – Structure with annotated atoms signfying interaction class

  • dcell (DistanceCell) – Distance cell to query for neighboring atoms

Returns

List of acceptors, donor pairs, and clashers atom indices

Return type

tuple[list[int], list[tuple[int, int]], list[int]]

get_dihedral_atoms(ct, h)
get_new_index(ct, atom_index, new_indices)
get_residue_name(ct, iatom)
hbond_heavy_max_angle = 140.0
hbond_heavy_min_angle = 80.0
hbond_min_angle = 150.0
max_hbond_distance = 3.5
pre_treat(ct)
swap_atoms(ct, atom1, atom2)
class rotatable_changeable(ct, iatom)[source]

Bases: schrodinger.protein.assignment.ProtAssign.changeable

asl = '((res.ptype "CYS ","CYT ") AND (atom.ptype " SG ") AND (atom.formal -1)) OR ((res.ptype "TYR ") AND (atom.ptype " OH ") AND (atom.formal -1)) OR (( atom.ele H AND not /C0-H0/ AND not /N0-H0/ ) AND NOT (res.ptype "HOH","DOD","SPC","ASH","GLH","ASP","GLU" ))'
__init__(ct, iatom)[source]

Initialize self. See help(type(self)) for accurate signature.

pre_treat_1(ct)[source]
pre_treat_2(ct)[source]
enumerate_states(ct, acceptors, donors, pH, do_flips=True, include_initial=False)[source]
lock_protonation()[source]
add_current_to_states(ct)[source]
assign_state(ct, istate, add_labels=True, label_pkas=False, state_gaps=None, verbose=False)[source]
update_atom_indices(ct, new_indices)[source]
get_heavies()[source]
get_state_sites(ct, istate)[source]
get_view_atoms()[source]
get_penalty(istate)[source]
get_adjustable_atoms()[source]
change_pka(pka, propka_pH)[source]
assign_state_gap(atom, state_gaps, report_gaps=True)

Write the Gap in energy between the lowest energy state and the state with different protonation states or heavy atom positions to the output ct :param atom: The atom that should have properties written to it :type atom:structure.StructureAtom :param state_gaps: The energy gaps between states for a given

changeable position.

Parameters

report_gaps (Boolean) – Whether to report the gaps to the log file as well

get_atom_name(ct, iatom)
get_close_interactors(ct, dcell)

Return acceptors, donors and clashers that are close to this changeable heavy atoms.

Parameters
  • ct (Structure) – Structure with annotated atoms signfying interaction class

  • dcell (DistanceCell) – Distance cell to query for neighboring atoms

Returns

List of acceptors, donor pairs, and clashers atom indices

Return type

tuple[list[int], list[tuple[int, int]], list[int]]

get_dihedral_atoms(ct, h)
get_new_index(ct, atom_index, new_indices)
get_residue_name(ct, iatom)
hbond_heavy_max_angle = 140.0
hbond_heavy_min_angle = 80.0
hbond_min_angle = 150.0
max_hbond_distance = 3.5
pre_treat(ct)
swap_atoms(ct, atom1, atom2)
class amine_changeable(ct, iatom)[source]

Bases: schrodinger.protein.assignment.ProtAssign.changeable

asl = '((res.ptype "LYS ","LYN ") AND (atom.ptype " NZ "))'
__init__(ct, iatom)[source]

Initialize self. See help(type(self)) for accurate signature.

pre_treat_1(ct)[source]
pre_treat_2(ct)[source]
enumerate_states(ct, acceptors, donors, pH, do_flips=True, sample_neutral_states=False, include_initial=False)[source]

Generate states for lysines.

States are generated by rotating hydrogens for acceptor/donor interactions and by optionally including the neutral state.

Parameters
  • ct (Structure) – Structure to generate states for

  • acceptors (List[int]) – List of acceptor atom indices

  • donors (List[(int, int)]) – List of donor atom indices

  • pH (float) – pH of system

  • do_flips (bool) – Does nothing

  • sample_neutral_states (bool) – Include neutral states. Since PROPKA’s pKa prediction is unreliable for Lys, currently we have no method of confidently assess whether it is neutral. So it’s turned off by default.

  • include_initial (bool) – Include the initial state of the Lys

lock_protonation()[source]
assign_state(ct, istate, add_labels=True, label_pkas=False, state_gaps=None, verbose=False)[source]
update_atom_indices(ct, new_indices)[source]
get_heavies()[source]
get_state_sites(ct, istate)[source]
get_view_atoms()[source]
get_penalty(istate)[source]
change_pka(pka, propka_pH)[source]
add_current_to_states(ct)
assign_state_gap(atom, state_gaps, report_gaps=True)

Write the Gap in energy between the lowest energy state and the state with different protonation states or heavy atom positions to the output ct :param atom: The atom that should have properties written to it :type atom:structure.StructureAtom :param state_gaps: The energy gaps between states for a given

changeable position.

Parameters

report_gaps (Boolean) – Whether to report the gaps to the log file as well

get_adjustable_atoms()
get_atom_name(ct, iatom)
get_close_interactors(ct, dcell)

Return acceptors, donors and clashers that are close to this changeable heavy atoms.

Parameters
  • ct (Structure) – Structure with annotated atoms signfying interaction class

  • dcell (DistanceCell) – Distance cell to query for neighboring atoms

Returns

List of acceptors, donor pairs, and clashers atom indices

Return type

tuple[list[int], list[tuple[int, int]], list[int]]

get_dihedral_atoms(ct, h)
get_new_index(ct, atom_index, new_indices)
get_residue_name(ct, iatom)
hbond_heavy_max_angle = 140.0
hbond_heavy_min_angle = 80.0
hbond_min_angle = 150.0
max_hbond_distance = 3.5
pre_treat(ct)
swap_atoms(ct, atom1, atom2)
class water_changeable(ct, iatom)[source]

Bases: schrodinger.protein.assignment.ProtAssign.changeable

asl = '(water) AND (atom.ele O)'
redundancy_tolerance = 0.5
__init__(ct, iatom)[source]

Initialize self. See help(type(self)) for accurate signature.

property nstates

Return number of enumerated states

enumerate_states(ct, acceptors, donors, pH, do_flips=True, include_initial=False)[source]

Generate discrete states for water, where a state is defined by the coordinates of its two hydrogens.

Parameters
  • ct (Structure) – Structure

  • acceptors (List[int]) – Acceptor atom indices

  • donors (List[Tuple(int, int)]) – Donor heavy-hydrogen atom indices

  • pH (float) – Does nothing here

  • do_flips (bool) – Does nothing here

  • include_initial (bool) – Include the current water orientation in the state list

add_current_to_states(ct)[source]
assign_state(ct, istate, add_labels=True, label_pkas=False, state_gaps=None, verbose=False)[source]
update_atom_indices(ct, new_indices)[source]
get_heavies()[source]
get_state_sites(ct, istate)[source]
get_view_atoms()[source]
get_penalty(istate)[source]
get_adjustable_atoms()[source]
assign_state_gap(atom, state_gaps, report_gaps=True)

Write the Gap in energy between the lowest energy state and the state with different protonation states or heavy atom positions to the output ct :param atom: The atom that should have properties written to it :type atom:structure.StructureAtom :param state_gaps: The energy gaps between states for a given

changeable position.

Parameters

report_gaps (Boolean) – Whether to report the gaps to the log file as well

change_pka(pka, propka_pH)
get_atom_name(ct, iatom)
get_close_interactors(ct, dcell)

Return acceptors, donors and clashers that are close to this changeable heavy atoms.

Parameters
  • ct (Structure) – Structure with annotated atoms signfying interaction class

  • dcell (DistanceCell) – Distance cell to query for neighboring atoms

Returns

List of acceptors, donor pairs, and clashers atom indices

Return type

tuple[list[int], list[tuple[int, int]], list[int]]

get_dihedral_atoms(ct, h)
get_new_index(ct, atom_index, new_indices)
get_residue_name(ct, iatom)
hbond_heavy_max_angle = 140.0
hbond_heavy_min_angle = 80.0
hbond_min_angle = 150.0
lock_protonation()
max_hbond_distance = 3.5
pre_treat(ct)
pre_treat_1(ct)
pre_treat_2(ct)
swap_atoms(ct, atom1, atom2)
class hbond_cluster[source]

Bases: object

get_residue_name(ct, iatom)[source]
get_atom_name(ct, iatom)[source]
__init__()[source]

Initialize self. See help(type(self)) for accurate signature.

setup_xtal(ct, interact, clustering_distance)[source]
optimize(ct, interact, static_donors, static_acceptors, static_clashers, max_comb, num_sequential_cycles, use_propka, propka_pH=7.0, xtal_ct=None)[source]
score_combination(ct, interact, states)[source]
single_point(ct, interact, static_donors, static_acceptors, static_clashers, xtal_ct=None)[source]
setup_local_static_alt(ct, static_acceptors, static_donors, static_clashers)[source]
setup_local_static(ct, static_acceptors, static_donors, static_clashers)[source]
initialize_score_storage()[source]
pre_score_self(ct)[source]
pre_score_pairs(ct, interact)[source]
score_pair(ct, iacceptors, idonors, iclashers, icharge, jacceptors, jdonors, jclashers, jcharge, use_xtal=False)[source]
score_donor_acceptor(ct, donor_heavy, donor_hydrogen, acceptor_heavy, use_xtal=False)[source]
score_donor_donor(ct, donor1_heavy, donor1_hydrogen, donor2_heavy, donor2_hydrogen, use_xtal=False)[source]
static calculate_distance_term(distance)[source]

Return distance dependent part of the hydrogen-bond potential functions.

static calculate_angle_term(angle)[source]

Return angle dependent part of the hydrogen bond potential.

Parameters
  • angle – Angle in degrees formed by H-D-A, with Hydrogen, Donor and Acceptor

  • angle – float

Returns

Score

Return type

float

static calculate_clash_term(distance, cutoff)[source]

Return clash term

score_exhaustively(ct, interact, find_all_solutions=True, tolerate_clashes=False)[source]
score_sequentially(ct, interact, num_sequential_cycles)[source]

This routine uses an algorithm similar to Prime’s iteration to convergence. Starting from a random configuration, each species is optimized in turn, keeping the others fixed in their current state. This continues until the system reaches convergence (no more changes in the most optimal state for all residues).

Parameters
  • ct (schrodigner.Structure) – input/output structure, will be modified

  • interact

    ??

  • num_sequential_cycles (int) – Number of cycles of randomization and optimization to conduct

expand_solutions(ct, interact)[source]

This takes an existing set of good solutions and generates more by deconverging them and then iterating them back to convergence. Generates at least 10 new solutions.

recombine_solutions(ct, interact)[source]

This is similar to score_sequentially, but begins with some pre-existing good solutions in self.combinations, and then creates hybrids to try to improve on them.

deconverge(ct, interact, comb, problem_cutoff=50.0)[source]

This starts with what is assumed to be a good solution, and then randomizes the states, but not to anything that produces a problem.

iterate_to_convergence(ct, interact, comb, problem_cutoff=50.0)[source]

This iterates the combination ‘comb’ to convergence. Maximum of 10 cycles.

create_hybrid(local_combinations, interact, random_scaffold=False)[source]

This takes the lowest energy solution, and for each problematic region it searches other solutions (in random order) for any which may have had better luck for just that part of the overall cluster. It then splices those solutions into the lowest energy one. If random_scaffold, then it selects a random solution as the basis in stead of the lowest energy one.

trim_redundant_combinations()[source]
assign_combination(ct, icombination, add_labels, label_pkas, verbose=False)[source]

Assign a given combination to this cluster :param ct: The structure to operate on :type ct:schrodinger.Structure :param icombination: The index of the combination to assign

or if this number is larger then the stored combinations, just keep the current state

:param add_labels:Whether to add labels to atoms to be

seen in maestro with the current protonation state

:type add_labels:Boolean :param label_pka:Whether to add labels for the pKa of each

residue

:type label_pka:Boolean :param verbose:Whether to report additional information

to the log file about the combination chosen

:type verbose:Boolean

determine_gap(icombination, ichangeable)[source]

Create a dictionary with the energy gaps to each of the various states. States that differ by only a hydrogen rotation are not considered unique :type icombination: integer :param icombination: the combination to use as the zero

point. In most situations this will be the lowest energy combination ( 0 when sorted)

Parameters

ichangeable (integer) – The residue number ( or position number) within the cluster which will be analyzed

Rparam

dictionary where the key is the name of the state or “Default” when the state is one of the staggers

Return type

dictionary with a key of string and value of a float

__init__(ct, interactive=False, do_flips=True, asl='', noprot_asl='', atoms=[], use_xtal=False, torsion_penalty=False, sample_waters=True, sample_acids=True, freeze_existing=False, include_initial=False, max_comb=10000, num_sequential_cycles=30, max_cluster_size=None, logging_level=1, quiet_flag=False, debug_flag=False, add_labels=True, label_pkas=False, pH='neutral', use_propka=True, propka_pH=7.0, user_states=[], minimize=False)[source]

Initialize self. See help(type(self)) for accurate signature.

fix_elements(ct)[source]
freeze_existing_hydrogens(ct)[source]
setup(ct)[source]
remove_zero_order_bonds(ct)[source]
extend_targeted_to_hyds(ct)[source]
delete_atoms(ct, atoms)[source]
run_propka(changeables, ct, use_xtal=False)[source]
generate_mates(ct)[source]
apply_pkas(changeables, changes, propka_pH)[source]
find_protonation_state_changes(ct, clusters='all')[source]
identify_species(ct)[source]
identify_all_hbonders(ct)[source]
annotate_structure(ct)[source]

Annotate atoms in structure by their interaction class and whether or not they are static

Internally updates the acceptors, donors and clashers attributes

enumerate_changeable_states(ct)[source]

Enumerate all states for each changeable. Crystal symmetry mates are taken into account if requested.

lock_protonation_states(ct)[source]
remove_changeables_from_hbonders()[source]
cluster(ct)[source]

Cluster changeables based on their heavies.

set_user_states(ct)[source]
assign_state_of_changeable(ct, ichangeable, istate)[source]
increment_state_of_changeable(ct, ichangeable)[source]
decrement_state_of_changeable(ct, ichangeable)[source]
record_current_indices(ct)[source]
assign_best_combinations(ct, last_time=False)[source]

Assign the best combinations to the ct and report output :param ct:The structure to operate on :type ct: schrodinger.Structure :param last_time: Whether or not this is the last time through

when we should be extra verbose

assign_cluster_combination(ct, icluster, icombination)[source]
single_point_cluster(ct, icluster)[source]
optimize_cluster(ct, icluster, assign=True)[source]
optimize(ct)[source]
minimize_hydrogens(ct)[source]
restore_zobs(ct)[source]
cleanup(ct)[source]
summarize_pkas()[source]