Source code for aiidalab_widgets_base.structures
"""Module to provide functionality to import structures."""
# pylint: disable=no-self-use
import datetime
import io
import tempfile
from collections import OrderedDict
# ASE imports
import ase
import ipywidgets as ipw
import numpy as np
# AiiDA imports
from aiida.engine import calcfunction
from aiida.orm import (
CalcFunctionNode,
CalcJobNode,
Data,
Node,
QueryBuilder,
WorkChainNode,
)
from aiida.plugins import DataFactory
from ase import Atom, Atoms
from ase.data import chemical_symbols, covalent_radii
from sklearn.decomposition import PCA
from traitlets import Instance, Int, List, Unicode, Union, default, dlink, link, observe
from .data import LigandSelectorWidget
# Local imports
from .utils import get_ase_from_file
from .viewers import StructureDataViewer
CifData = DataFactory("cif") # pylint: disable=invalid-name
StructureData = DataFactory("structure") # pylint: disable=invalid-name
SYMBOL_RADIUS = {key: covalent_radii[i] for i, key in enumerate(chemical_symbols)}
[docs]class StructureManagerWidget(ipw.VBox):
"""Upload a structure and store it in AiiDA database.
Attributes:
structure(Atoms): trait that contains the selected structure. 'None' if no structure is selected.
structure_node(StructureData, CifData): trait that contains AiiDA structure object
node_class(str): trait that contains structure_node type (as string).
"""
input_structure = Union([Instance(Atoms), Instance(Data)], allow_none=True)
structure = Union([Instance(Atoms), Instance(Data)], allow_none=True)
structure_node = Instance(Data, allow_none=True, read_only=True)
node_class = Unicode()
SUPPORTED_DATA_FORMATS = {"CifData": "cif", "StructureData": "structure"}
[docs] def __init__(
self,
importers,
viewer=None,
editors=None,
storable=True,
node_class=None,
**kwargs,
):
"""
Arguments:
importers(list): list of tuples each containing the displayed name of importer and the
importer object. Each object should contain 'structure' trait pointing to the imported
structure. The trait will be linked to 'structure' trait of this class.
storable(bool): Whether to provide Store button (together with Store format)
node_class(str): AiiDA node class for storing the structure.
Possible values: 'StructureData', 'CifData' or None (let the user decide).
Note: If your workflows require a specific node class, better fix it here.
"""
# History of modifications
self.history = []
# Undo functionality.
btn_undo = ipw.Button(description="Undo", button_style="success")
btn_undo.on_click(self.undo)
self.structure_set_by_undo = False
# To keep track of last inserted structure object
self._inserted_structure = None
# Structure viewer.
if viewer:
self.viewer = viewer
else:
self.viewer = StructureDataViewer(downloadable=False)
dlink((self, "structure_node"), (self.viewer, "structure"))
# Store button.
self.btn_store = ipw.Button(description="Store in AiiDA", disabled=True)
self.btn_store.on_click(self.store_structure)
# Label and description that are stored along with the new structure.
self.structure_label = ipw.Text(description="Label")
self.structure_description = ipw.Text(description="Description")
# Store format selector.
data_format = ipw.RadioButtons(
options=self.SUPPORTED_DATA_FORMATS, description="Data type:"
)
link((data_format, "label"), (self, "node_class"))
# Store button, store class selector, description.
store_and_description = [self.btn_store] if storable else []
if node_class is None:
store_and_description.append(data_format)
elif node_class in self.SUPPORTED_DATA_FORMATS:
self.node_class = node_class
else:
raise ValueError(
"Unknown data format '{}'. Options: {}".format(
node_class, list(self.SUPPORTED_DATA_FORMATS.keys())
)
)
self.output = ipw.HTML("")
children = [
self._structure_importers(importers),
self.viewer,
ipw.HBox(
store_and_description
+ [self.structure_label, self.structure_description]
),
]
structure_editors = self._structure_editors(editors)
if structure_editors:
structure_editors = ipw.VBox([btn_undo, structure_editors])
accordion = ipw.Accordion([structure_editors])
accordion.selected_index = None
accordion.set_title(0, "Edit Structure")
children += [accordion]
super().__init__(children=children + [self.output], **kwargs)
[docs] def _structure_importers(self, importers):
"""Preparing structure importers."""
if not importers:
raise ValueError(
"The parameter importers should contain a list (or tuple) of "
"importers, got a falsy object."
)
# If there is only one importer - no need to make tabs.
if len(importers) == 1:
# Assigning a function which will be called when importer provides a structure.
dlink((importers[0], "structure"), (self, "input_structure"))
return importers[0]
# Otherwise making one tab per importer.
importers_tab = ipw.Tab()
importers_tab.children = [i for i in importers] # One importer per tab.
for i, importer in enumerate(importers):
# Labeling tabs.
importers_tab.set_title(i, importer.title)
dlink((importer, "structure"), (self, "input_structure"))
return importers_tab
[docs] def _structure_editors(self, editors):
"""Preparing structure editors."""
if editors and len(editors) == 1:
link((editors[0], "structure"), (self, "structure"))
if editors[0].has_trait("selection"):
link((editors[0], "selection"), (self.viewer, "selection"))
if editors[0].has_trait("camera_orientation"):
dlink(
(self.viewer._viewer, "_camera_orientation"),
(editors[0], "camera_orientation"),
) # pylint: disable=protected-access
return editors[0]
# If more than one editor was defined.
if editors:
editors_tab = ipw.Tab()
editors_tab.children = tuple(editors)
for i, editor in enumerate(editors):
editors_tab.set_title(i, editor.title)
link((editor, "structure"), (self, "structure"))
if editor.has_trait("selection"):
link((editor, "selection"), (self.viewer, "selection"))
if editor.has_trait("camera_orientation"):
dlink(
(self.viewer._viewer, "_camera_orientation"),
(editor, "camera_orientation"),
) # pylint: disable=protected-access
return editors_tab
return None
[docs] def store_structure(self, _=None):
"""Stores the structure in AiiDA database."""
if self.structure_node is None:
return
if self.structure_node.is_stored:
self.output.value = "Already stored in AiiDA [{}], skipping...".format(
self.structure_node
)
return
self.btn_store.disabled = True
self.structure_node.label = self.structure_label.value
self.structure_label.disabled = True
self.structure_node.description = self.structure_description.value
self.structure_description.disabled = True
if isinstance(self.input_structure, Data) and self.input_structure.is_stored:
# Make a link between self.input_structure and self.structure_node
@calcfunction
def user_modifications(source_structure): # pylint: disable=unused-argument
return self.structure_node
structure_node = user_modifications(self.input_structure)
else:
structure_node = self.structure_node.store()
self.output.value = "Stored in AiiDA [{}]".format(structure_node)
[docs] def undo(self, _):
"""Undo modifications."""
self.structure_set_by_undo = True
if self.history:
self.history = self.history[:-1]
if self.history:
self.structure = self.history[-1]
else:
self.input_structure = None
self.structure_set_by_undo = False
@staticmethod
@default("node_class")
def _default_node_class():
return "StructureData"
@observe("node_class")
def _change_structure_node(self, _=None):
with self.hold_trait_notifications():
self._sync_structure_node()
[docs] def _sync_structure_node(self):
"""Synchronize the structure_node trait using the currently provided info."""
if len(self.history) > 1:
# There are some modifications, so converting from ASE.
structure_node = self._convert_to_structure_node(self.structure)
else:
structure_node = self._convert_to_structure_node(self.input_structure)
self.set_trait("structure_node", structure_node)
[docs] def _convert_to_structure_node(self, structure):
"""Convert structure of any type to the StructureNode object."""
if structure is None:
return None
structure_node_type = DataFactory(
self.SUPPORTED_DATA_FORMATS[self.node_class]
) # pylint: disable=invalid-name
# If the input_structure trait is set to Atoms object, structure node must be created from it.
if isinstance(structure, Atoms):
# If the Atoms object was created by SmilesWidget,
# attach its SMILES code as an extra.
structure_node = structure_node_type(ase=structure)
if "smiles" in structure.info:
structure_node.set_extra("smiles", structure.info["smiles"])
return structure_node
# If the input_structure trait is set to AiiDA node, check what type
if isinstance(structure, Data):
# Transform the structure to the structure_node_type if needed.
if isinstance(structure, structure_node_type):
return structure
# Using self.structure, as it was already converted to the ASE Atoms object.
return structure_node_type(ase=self.structure)
@observe("structure_node")
def _observe_structure_node(self, change):
"""Modify structure label and description when a new structure is provided."""
struct = change["new"]
if struct is None:
self.btn_store.disabled = True
self.structure_label.value = ""
self.structure_label.disabled = True
self.structure_description.value = ""
self.structure_description.disabled = True
return
if struct.is_stored:
self.btn_store.disabled = True
self.structure_label.value = struct.label
self.structure_label.disabled = True
self.structure_description.value = struct.description
self.structure_description.disabled = True
else:
self.btn_store.disabled = False
self.structure_label.value = self.structure.get_chemical_formula()
self.structure_label.disabled = False
self.structure_description.value = ""
self.structure_description.disabled = False
@observe("input_structure")
def _observe_input_structure(self, change):
"""Returns ASE atoms object and sets structure_node trait."""
# If the `input_structure` trait is set to Atoms object, then the `structure` trait should be set to it as well.
self.history = []
if isinstance(change["new"], Atoms):
self.structure = change["new"]
# If the `input_structure` trait is set to AiiDA node, then the `structure` trait should
# be converted to an ASE Atoms object.
elif isinstance(
change["new"], CifData
): # Special treatement of the CifData object
str_io = io.StringIO(change["new"].get_content())
self.structure = ase.io.read(
str_io, format="cif", reader="ase", store_tags=True
)
elif isinstance(change["new"], StructureData):
self.structure = change["new"].get_ase()
else:
self.structure = None
@observe("structure")
def _structure_changed(self, change=None):
"""Perform some operations that depend on the value of `structure` trait.
This function enables/disables `btn_store` widget if structure is provided/set to None.
Also, the function sets `structure_node` trait to the selected node type.
"""
if not self.structure_set_by_undo:
self.history.append(change["new"])
# If structure trait was set to None, structure_node should become None as well.
if self.structure is None:
self.set_trait("structure_node", None)
self.btn_store.disabled = True
return
self.btn_store.disabled = False
with self.hold_trait_notifications():
self._sync_structure_node()
[docs]class StructureUploadWidget(ipw.VBox):
"""Class that allows to upload structures from user's computer."""
structure = Union([Instance(Atoms), Instance(Data)], allow_none=True)
[docs] def __init__(self, title="", description="Upload Structure"):
self.title = title
self.file_upload = ipw.FileUpload(
description=description, multiple=False, layout={"width": "initial"}
)
supported_formats = ipw.HTML(
"""<a href="https://wiki.fysik.dtu.dk/ase/ase/io/io.html#ase.io.write" target="_blank">
Supported structure formats
</a>"""
)
self.file_upload.observe(self._on_file_upload, names="value")
super().__init__(children=[self.file_upload, supported_formats])
[docs] def _validate_and_fix_ase_cell(self, ase_structure, vacuum_ang=10.0):
"""
Checks if the ase Atoms object has a cell set,
otherwise sets it to bounding box plus specified "vacuum" space
"""
cell = ase_structure.cell
if (
np.linalg.norm(cell[0]) < 0.1
or np.linalg.norm(cell[1]) < 0.1
or np.linalg.norm(cell[2]) < 0.1
):
# if any of the cell vectors is too short, consider it faulty
# set cell as bounding box + vacuum_ang
bbox = np.ptp(ase_structure.positions, axis=0)
new_structure = ase_structure.copy()
new_structure.cell = bbox + vacuum_ang
return new_structure
return ase_structure
[docs] def _on_file_upload(self, change=None):
"""When file upload button is pressed."""
for fname, item in change["new"].items():
frmt = fname.split(".")[-1]
if frmt == "cif":
self.structure = CifData(file=io.BytesIO(item["content"]))
else:
with tempfile.NamedTemporaryFile(suffix=f".{frmt}") as temp_file:
temp_file.write(item["content"])
temp_file.flush()
self.structure = self._validate_and_fix_ase_cell(
get_ase_from_file(temp_file.name)
)
self.file_upload.value.clear()
break
[docs]class StructureExamplesWidget(ipw.VBox):
"""Class to provide example structures for selection."""
structure = Instance(Atoms, allow_none=True)
[docs] def __init__(self, examples, title="", **kwargs):
self.title = title
self.on_structure_selection = lambda structure_ase, name: None
self._select_structure = ipw.Dropdown(
options=self.get_example_structures(examples)
)
self._select_structure.observe(self._on_select_structure, names=["value"])
super().__init__(children=[self._select_structure], **kwargs)
[docs] @staticmethod
def get_example_structures(examples):
"""Get the list of example structures."""
if not isinstance(examples, list):
raise ValueError(
"parameter examples should be of type list, {} given".format(
type(examples)
)
)
return [("Select structure", False)] + examples
[docs] def _on_select_structure(self, change): # pylint: disable=unused-argument
"""When structure is selected."""
self.structure = (
get_ase_from_file(self._select_structure.value)
if self._select_structure.value
else None
)
@default("structure")
def _default_structure(self):
return None
[docs]class StructureBrowserWidget(ipw.VBox):
"""Class to query for structures stored in the AiiDA database."""
structure = Union([Instance(Atoms), Instance(Data)], allow_none=True)
[docs] def __init__(self, title=""):
self.title = title
# Structure objects we want to query for.
self.query_structure_type = (DataFactory("structure"), DataFactory("cif"))
# Extracting available process labels.
qbuilder = QueryBuilder().append((CalcJobNode, WorkChainNode), project="label")
self.drop_label = ipw.Dropdown(
options=sorted({"All"}.union({i[0] for i in qbuilder.iterall() if i[0]})),
value="All",
description="Process Label",
disabled=True,
style={"description_width": "120px"},
layout={"width": "50%"},
)
self.drop_label.observe(self.search, names="value")
# Disable process labels selection if we are not looking for the calculated structures.
def disable_drop_label(change):
self.drop_label.disabled = not change["new"] == "calculated"
# Select structures kind.
self.mode = ipw.RadioButtons(
options=["all", "uploaded", "edited", "calculated"], layout={"width": "25%"}
)
self.mode.observe(self.search, names="value")
self.mode.observe(disable_drop_label, names="value")
# Date range.
# Note: there is Date picker widget, but it currently does not work in Safari:
# https://ipywidgets.readthedocs.io/en/latest/examples/Widget%20List.html#Date-picker
date_text = ipw.HTML(value="<p>Select the date range:</p>")
self.start_date_widget = ipw.Text(
value="", description="From: ", style={"description_width": "120px"}
)
self.end_date_widget = ipw.Text(value="", description="To: ")
# Search button.
btn_search = ipw.Button(
description="Search",
button_style="info",
layout={"width": "initial", "margin": "2px 0 0 2em"},
)
btn_search.on_click(self.search)
age_selection = ipw.VBox(
[
date_text,
ipw.HBox([self.start_date_widget, self.end_date_widget, btn_search]),
],
layout={"border": "1px solid #fafafa", "padding": "1em"},
)
h_line = ipw.HTML("<hr>")
box = ipw.VBox([age_selection, h_line, ipw.HBox([self.mode, self.drop_label])])
self.results = ipw.Dropdown(layout={"width": "900px"})
self.results.observe(self._on_select_structure, names="value")
self.search()
super().__init__([box, h_line, self.results])
[docs] def preprocess(self):
"""Search structures in AiiDA database and add formula extra to them."""
queryb = QueryBuilder()
queryb.append(
self.query_structure_type, filters={"extras": {"!has_key": "formula"}}
)
for item in queryb.all(): # iterall() would interfere with set_extra()
try:
formula = item[0].get_formula()
except AttributeError:
# Slow part.
formula = item[0].get_ase().get_chemical_formula()
item[0].set_extra("formula", formula)
[docs] def search(self, _=None):
"""Launch the search of structures in AiiDA database."""
self.preprocess()
qbuild = QueryBuilder()
# If the date range is valid, use it for the search
try:
start_date = datetime.datetime.strptime(
self.start_date_widget.value, "%Y-%m-%d"
)
end_date = datetime.datetime.strptime(
self.end_date_widget.value, "%Y-%m-%d"
) + datetime.timedelta(hours=24)
# Otherwise revert to the standard (i.e. last 7 days)
except ValueError:
start_date = datetime.datetime.now() - datetime.timedelta(days=7)
end_date = datetime.datetime.now() + datetime.timedelta(hours=24)
self.start_date_widget.value = start_date.strftime("%Y-%m-%d")
self.end_date_widget.value = end_date.strftime("%Y-%m-%d")
filters = {}
filters["ctime"] = {"and": [{">": start_date}, {"<=": end_date}]}
if self.mode.value == "uploaded":
qbuild2 = (
QueryBuilder()
.append(self.query_structure_type, project=["id"], tag="structures")
.append(Node, with_outgoing="structures")
)
processed_nodes = [n[0] for n in qbuild2.all()]
if processed_nodes:
filters["id"] = {"!in": processed_nodes}
qbuild.append(self.query_structure_type, filters=filters)
elif self.mode.value == "calculated":
if self.drop_label.value == "All":
qbuild.append((CalcJobNode, WorkChainNode), tag="calcjobworkchain")
else:
qbuild.append(
(CalcJobNode, WorkChainNode),
filters={"label": self.drop_label.value},
tag="calcjobworkchain",
)
qbuild.append(
self.query_structure_type,
with_incoming="calcjobworkchain",
filters=filters,
)
elif self.mode.value == "edited":
qbuild.append(CalcFunctionNode)
qbuild.append(
self.query_structure_type,
with_incoming=CalcFunctionNode,
filters=filters,
)
elif self.mode.value == "all":
qbuild.append(self.query_structure_type, filters=filters)
qbuild.order_by({self.query_structure_type: {"ctime": "desc"}})
matches = {n[0] for n in qbuild.iterall()}
matches = sorted(matches, reverse=True, key=lambda n: n.ctime)
options = OrderedDict()
options["Select a Structure ({} found)".format(len(matches))] = False
for mch in matches:
label = "PK: {}".format(mch.id)
label += " | " + mch.ctime.strftime("%Y-%m-%d %H:%M")
label += " | " + mch.get_extra("formula")
label += " | " + mch.node_type.split(".")[-2]
label += " | " + mch.label
label += " | " + mch.description
options[label] = mch
self.results.options = options
[docs]class SmilesWidget(ipw.VBox):
"""Conver SMILES into 3D structure."""
structure = Instance(Atoms, allow_none=True)
SPINNER = """<i class="fa fa-spinner fa-pulse" style="color:red;" ></i>"""
[docs] def __init__(self, title=""):
# pylint: disable=unused-import
self.title = title
try:
from openbabel import openbabel # noqa: F401
from openbabel import pybel # noqa: F401
except ImportError:
super().__init__(
[
ipw.HTML(
"The SmilesWidget requires the OpenBabel library, "
"but the library was not found."
)
]
)
return
try:
from rdkit import Chem # noqa: F401
from rdkit.Chem import AllChem # noqa: F401
except ImportError:
super().__init__(
[
ipw.HTML(
"The SmilesWidget requires the rdkit library, "
"but the library was not found."
)
]
)
return
self.smiles = ipw.Text(placeholder="C=C")
self.create_structure_btn = ipw.Button(
description="Generate molecule", button_style="info"
)
self.create_structure_btn.on_click(self._on_button_pressed)
self.output = ipw.HTML("")
super().__init__([self.smiles, self.create_structure_btn, self.output])
[docs] def _make_ase(self, species, positions, smiles):
"""Create ase Atoms object."""
# Get the principal axes and realign the molecule along z-axis.
positions = PCA(n_components=3).fit_transform(positions)
atoms = Atoms(species, positions=positions, pbc=True)
atoms.cell = np.ptp(atoms.positions, axis=0) + 10
atoms.center()
# We're attaching this info so that it
# can be later stored as an extra on AiiDA Structure node.
atoms.info["smiles"] = smiles
return atoms
[docs] def _pybel_opt(self, smiles, steps):
"""Optimize a molecule using force field and pybel (needed for complex SMILES)."""
from openbabel import openbabel as ob
from openbabel import pybel as pb
obconversion = ob.OBConversion()
obconversion.SetInFormat("smi")
obmol = ob.OBMol()
obconversion.ReadString(obmol, smiles)
pbmol = pb.Molecule(obmol)
pbmol.make3D(forcefield="uff", steps=50)
pbmol.localopt(forcefield="gaff", steps=200)
pbmol.localopt(forcefield="mmff94", steps=100)
f_f = pb._forcefields["uff"] # pylint: disable=protected-access
f_f.Setup(pbmol.OBMol)
f_f.ConjugateGradients(steps, 1.0e-9)
f_f.GetCoordinates(pbmol.OBMol)
species = [chemical_symbols[atm.atomicnum] for atm in pbmol.atoms]
positions = np.asarray([atm.coords for atm in pbmol.atoms])
return self._make_ase(species, positions, smiles)
[docs] def _rdkit_opt(self, smiles, steps):
"""Optimize a molecule using force field and rdkit (needed for complex SMILES)."""
from rdkit import Chem
from rdkit.Chem import AllChem
smiles = smiles.replace("[", "").replace("]", "")
mol = Chem.MolFromSmiles(smiles)
mol = Chem.AddHs(mol)
AllChem.EmbedMolecule(mol, maxAttempts=20, randomSeed=42)
AllChem.UFFOptimizeMolecule(mol, maxIters=steps)
positions = mol.GetConformer().GetPositions()
natoms = mol.GetNumAtoms()
species = [mol.GetAtomWithIdx(j).GetSymbol() for j in range(natoms)]
return self._make_ase(species, positions, smiles)
[docs] def _mol_from_smiles(self, smiles, steps=10000):
"""Convert SMILES to ase structure try rdkit then pybel"""
try:
return self._rdkit_opt(smiles, steps)
except ValueError:
return self._pybel_opt(smiles, steps)
[docs] def _on_button_pressed(self, change): # pylint: disable=unused-argument
"""Convert SMILES to ase structure when button is pressed."""
self.output.value = ""
if not self.smiles.value:
return
self.output.value = "Screening possible conformers {}".format(
self.SPINNER
) # font-size:20em;
self.structure = self._mol_from_smiles(self.smiles.value)
self.output.value = ""
@default("structure")
def _default_structure(self):
return None
[docs]class BasicStructureEditor(ipw.VBox): # pylint: disable=too-many-instance-attributes
"""Widget that allows for the basic structure editing."""
structure = Instance(Atoms, allow_none=True)
selection = List(Int)
camera_orientation = List()
[docs] def __init__(self, title=""):
self.title = title
# Define action vector.
self.axis_p1 = ipw.Text(
description="Starting point", value="0 0 0", layout={"width": "initial"}
)
self.axis_p2 = ipw.Text(
description="Ending point", value="0 0 1", layout={"width": "initial"}
)
btn_def_atom1 = ipw.Button(
description="From selection", layout={"width": "initial"}
)
btn_def_atom1.on_click(self.def_axis_p1)
btn_def_atom2 = ipw.Button(
description="From selection", layout={"width": "initial"}
)
btn_def_atom2.on_click(self.def_axis_p2)
btn_get_from_camera = ipw.Button(
description="Perp. to screen",
button_style="warning",
layout={"width": "initial"},
)
btn_get_from_camera.on_click(self.def_perpendicular_to_screen)
# Define action point.
self.point = ipw.Text(
description="Action point", value="0 0 0", layout={"width": "initial"}
)
btn_def_pnt = ipw.Button(
description="From selection", layout={"width": "initial"}
)
btn_def_pnt.on_click(self.def_point)
# Move atoms.
btn_move_dr = ipw.Button(description="Move", layout={"width": "initial"})
btn_move_dr.on_click(self.translate_dr)
self.displacement = ipw.FloatText(
description=r"Move along action vector by $\Delta=$ ",
value=1,
step=0.1,
style={"description_width": "initial"},
layout={"width": "initial"},
)
btn_move_dxyz = ipw.Button(
description="Move by XYZ", layout={"width": "initial"}
)
btn_move_dxyz.on_click(self.translate_dxdydz)
btn_move_to_xyz = ipw.Button(
description="Move to XYZ", layout={"width": "initial"}
)
btn_move_to_xyz.on_click(self.translate_to_xyz)
self.dxyz = ipw.Text(
description="XYZ move:",
value="0 0 0",
style={"description_width": "initial"},
layout={"width": "initial", "margin": "0px 0px 0px 20px"},
)
# Rotate atoms.
btn_rotate = ipw.Button(description="Rotate", layout={"width": "10%"})
btn_rotate.on_click(self.rotate)
self.phi = ipw.FloatText(
description="Rotate around the action vector which starts from the action point",
value=0,
step=5,
style={"description_width": "initial"},
layout={"width": "initial"},
)
# Mirror atoms.
btn_mirror_perp = ipw.Button(description="Mirror", layout={"width": "10%"})
btn_mirror_perp.on_click(self.mirror)
btn_mirror_3p = ipw.Button(description="Mirror", layout={"width": "10%"})
btn_mirror_3p.on_click(self.mirror_3p)
# Rotate atoms while aligning action vector with XYZ vector.
btn_align = ipw.Button(description="Align", layout={"width": "10%"})
btn_align.on_click(self.align)
# Atoms selection.
self.element = ipw.Dropdown(
description="Select element",
options=chemical_symbols[1:],
value="H",
style={"description_width": "initial"},
layout={"width": "initial"},
)
def disable_element(_=None):
if self.ligand.value == 0:
self.element.disabled = False
else:
self.element.disabled = True
# Ligand selection.
self.ligand = LigandSelectorWidget()
self.ligand.observe(disable_element, names="value")
# Add atom.
btn_add = ipw.Button(description="Add to selected", layout={"width": "initial"})
btn_add.on_click(self.add)
self.bond_length = ipw.FloatText(
description="Bond lenght.", value=1.0, layout={"width": "140px"}
)
use_covalent_radius = ipw.Checkbox(
value=True,
description="Use covalent radius",
style={"description_width": "initial"},
)
link((use_covalent_radius, "value"), (self.bond_length, "disabled"))
# Copy atoms.
btn_copy_sel = ipw.Button(
description="Copy selected", layout={"width": "initial"}
)
btn_copy_sel.on_click(self.copy_sel)
# Modify atom.
btn_modify = ipw.Button(
description="Modify selected",
button_style="warning",
layout={"width": "initial"},
)
btn_modify.on_click(self.mod_element)
# Remove atom.
btn_remove = ipw.Button(
description="Remove selected",
button_style="danger",
layout={"width": "initial"},
)
btn_remove.on_click(self.remove)
# Automatically clear selection after point definition
self.autoclear_selection = ipw.Checkbox(
description='Clear selection after pressing "From seletion"',
value=True,
style={"description_width": "initial"},
)
super().__init__(
children=[
ipw.HTML(
"<b>Action vector and point:</b>",
layout={"margin": "20px 0px 10px 0px"},
),
ipw.HBox(
[
self.axis_p1,
btn_def_atom1,
self.axis_p2,
btn_def_atom2,
btn_get_from_camera,
],
layout={"margin": "0px 0px 0px 20px"},
),
ipw.HBox(
[self.point, btn_def_pnt, self.autoclear_selection],
layout={"margin": "0px 0px 0px 20px"},
),
ipw.HTML(
"<b>Move atom(s):</b>", layout={"margin": "20px 0px 10px 0px"}
),
ipw.HBox(
[
self.displacement,
btn_move_dr,
self.dxyz,
btn_move_dxyz,
btn_move_to_xyz,
],
layout={"margin": "0px 0px 0px 20px"},
),
ipw.HBox([self.phi, btn_rotate], layout={"margin": "0px 0px 0px 20px"}),
ipw.HBox(
[
ipw.HTML(
"Mirror on the plane perpendicular to the action vector",
layout={"margin": "0px 0px 0px 0px"},
),
btn_mirror_perp,
],
layout={"margin": "0px 0px 0px 20px"},
),
ipw.HBox(
[
ipw.HTML(
"Mirror on the plane containing action vector and action point",
layout={"margin": "0px 0px 0px 0px"},
),
btn_mirror_3p,
],
layout={"margin": "0px 0px 0px 20px"},
),
ipw.HBox(
[
ipw.HTML(
"Rotate atoms while aligning the action vector with the XYZ vector",
layout={"margin": "0px 0px 0px 0px"},
),
btn_align,
],
layout={"margin": "0px 0px 0px 20px"},
),
ipw.HTML(
"<b>Modify atom(s):</v>", layout={"margin": "20px 0px 10px 0px"}
),
ipw.HBox([btn_copy_sel], layout={"margin": "0px 0px 0px 20px"}),
ipw.HBox(
[self.element, self.ligand], layout={"margin": "0px 0px 0px 20px"}
),
ipw.HBox(
[
btn_modify,
btn_add,
self.bond_length,
use_covalent_radius,
],
layout={"margin": "0px 0px 0px 20px"},
),
ipw.HBox([btn_remove], layout={"margin": "0px 0px 0px 20px"}),
]
)
[docs] def vec2str(self, vector):
return (
str(round(vector[0], 2))
+ " "
+ str(round(vector[1], 2))
+ " "
+ str(round(vector[2], 2))
)
[docs] def sel2com(self):
"""Get center of mass of the selection."""
if self.selection:
com = np.average(self.structure[self.selection].get_positions(), axis=0)
else:
com = [0, 0, 0]
return com
@property
def action_vector(self):
"""Define the action vector."""
normal = self.str2vec(self.axis_p2.value) - self.str2vec(self.axis_p1.value)
return normal / np.linalg.norm(normal)
[docs] def def_point(self, _=None):
"""Define the action point."""
self.point.value = self.vec2str(self.sel2com())
if self.autoclear_selection.value:
self.selection = list()
[docs] def def_axis_p1(self, _=None):
"""Define the first point of axis."""
self.axis_p1.value = self.vec2str(self.sel2com())
if self.autoclear_selection.value:
self.selection = list()
[docs] def def_axis_p2(self, _=None):
"""Define the second point of axis."""
com = (
np.average(self.structure[self.selection].get_positions(), axis=0)
if self.selection
else [0, 0, 1]
)
self.axis_p2.value = self.vec2str(com)
if self.autoclear_selection.value:
self.selection = list()
[docs] def def_perpendicular_to_screen(self, _=None):
"""Define a normalized vector perpendicular to the screen."""
cmr = self.camera_orientation
if cmr:
self.axis_p1.value = "0 0 0"
versor = np.array([-cmr[2], -cmr[6], -cmr[10]]) / np.linalg.norm(
[-cmr[2], -cmr[6], -cmr[10]]
)
self.axis_p2.value = self.vec2str(versor.tolist())
[docs] def translate_dr(self, _=None):
"""Translate by dr along the selected vector."""
atoms = self.structure.copy()
selection = self.selection
atoms.positions[self.selection] += np.array(
self.action_vector * self.displacement.value
)
self.structure = atoms
self.selection = selection
[docs] def translate_dxdydz(self, _=None):
"""Translate by the selected XYZ delta."""
selection = self.selection
atoms = self.structure.copy()
# The action.
atoms.positions[self.selection] += np.array(self.str2vec(self.dxyz.value))
self.structure = atoms
self.selection = selection
[docs] def translate_to_xyz(self, _=None):
"""Translate to the selected XYZ position."""
selection = self.selection
atoms = self.structure.copy()
# The action.
geo_center = np.average(self.structure[self.selection].get_positions(), axis=0)
atoms.positions[self.selection] += self.str2vec(self.dxyz.value) - geo_center
self.structure = atoms
self.selection = selection
[docs] def rotate(self, _=None):
"""Rotate atoms around selected point in space and vector."""
selection = self.selection
atoms = self.structure.copy()
# The action.
rotated_subset = atoms[self.selection]
vec = self.str2vec(self.vec2str(self.action_vector))
center = self.str2vec(self.point.value)
rotated_subset.rotate(self.phi.value, v=vec, center=center, rotate_cell=False)
atoms.positions[list(self.selection)] = rotated_subset.positions
self.structure = atoms
self.selection = selection
[docs] def mirror(self, _=None, norm=None, point=None):
"""Mirror atoms on the plane perpendicular to the action vector."""
selection = self.selection
atoms = self.structure.copy()
# The action.
# Vector and point define the mirrorring surface.
p_normal = norm if norm is not None else self.action_vector
p_point = point if point is not None else self.str2vec(self.point.value)
# Check if norm vector makes sense.
if np.isnan(p_normal).any() or np.linalg.norm(p_normal) < 1e-4:
return
# Define vectors from p_point that point to the atoms which are to be moved.
mirror_subset = atoms.positions[selection] - p_point
# Project vectors onto the plane normal.
projections = (
p_normal
* np.dot(mirror_subset, p_normal)[:, np.newaxis]
/ np.dot(p_normal, p_normal)
)
# Mirror atoms.
atoms.positions[selection] -= 2 * projections
self.structure = atoms
self.selection = selection
[docs] def mirror_3p(self, _=None):
"""Mirror atoms on the plane containing action vector and action point."""
pt1 = self.str2vec(self.axis_p2.value)
pt2 = self.str2vec(self.axis_p1.value)
pt3 = self.str2vec(self.point.value)
normal = np.cross(pt1 - pt2, pt3 - pt2)
normal = normal / np.linalg.norm(normal)
self.mirror(norm=normal, point=pt3)
[docs] def align(self, _=None):
"""Rotate atoms to align action vector with XYZ vector."""
atoms = self.structure.copy()
selection = self.selection
if not self.selection:
return
# The action.
center = self.str2vec(self.point.value)
subset = atoms[selection]
subset.rotate(self.action_vector, self.str2vec(self.dxyz.value), center=center)
atoms.positions[selection] = subset.positions
self.structure = atoms
self.selection = selection
[docs] def mod_element(self, _=None):
"""Modify selected atoms into the given element."""
atoms = self.structure.copy()
selection = self.selection
if self.ligand.value == 0:
for idx in self.selection:
new = Atom(self.element.value)
atoms[idx].mass = new.mass
atoms[idx].magmom = new.magmom
atoms[idx].momentum = new.momentum
atoms[idx].symbol = new.symbol
atoms[idx].tag = new.tag
atoms[idx].charge = new.charge
else:
initial_ligand = self.ligand.rotate(
align_to=self.action_vector, remove_anchor=True
)
for idx in self.selection:
position = self.structure.positions[idx].copy()
lgnd = initial_ligand.copy()
lgnd.translate(position)
atoms += lgnd
self.structure = atoms
self.selection = selection
[docs] def copy_sel(self, _=None):
"""Copy selected atoms and shift by 1.0 A along X-axis."""
atoms = self.structure.copy()
last_atom = atoms.get_global_number_of_atoms()
selection = self.selection
# The action
add_atoms = atoms[self.selection].copy()
add_atoms.translate([1.0, 0, 0])
atoms += add_atoms
self.structure = atoms
self.selection = [i for i in range(last_atom, last_atom + len(selection))]
[docs] def add(self, _=None):
"""Add atoms."""
atoms = self.structure.copy()
selection = self.selection
if self.ligand.value == 0:
initial_ligand = Atoms([Atom(self.element.value, [0, 0, 0])])
rad = SYMBOL_RADIUS[self.element.value]
else:
initial_ligand = self.ligand.rotate(align_to=self.action_vector)
rad = SYMBOL_RADIUS[self.ligand.anchoring_atom]
for idx in self.selection:
# It is important to copy, otherwise the initial structure will be modified
position = self.structure.positions[idx].copy()
lgnd = initial_ligand.copy()
if self.bond_length.disabled:
lgnd.translate(
position
+ self.action_vector
* (SYMBOL_RADIUS[self.structure.symbols[idx]] + rad)
)
else:
lgnd.translate(position + self.action_vector * self.bond_length.value)
atoms += lgnd
self.structure = atoms
self.selection = selection
[docs] def remove(self, _):
"""Remove selected atoms."""
atoms = self.structure.copy()
del [atoms[self.selection]]
self.structure = atoms