Daylight v4.9
Release Date: 1 February 2008

Name

dt_utransform - apply a reaction transform to an object

Generic Prototype

dt_utransform(dt_Handle, dt_Handle, dt_Integer, dt_Integer) => dt_Handle

C Prototype

#include "dt_smarts.h"

dt_Handle dt_utransform(dt_Handle transform, dt_Handle som, dt_Integer direction, dt_Integer limit)

FORTRAN Prototype

include 'dt_f_smarts.inc'

integer*4 dt_f_utransform(transform, som, direction, limit)

integer*4 transform
integer*4 som
integer*4 direction
integer*4 limit

Description

Applies the given transform to the molecule or sequence of molecules 'som'. If 'som' is a sequence of molecules, the molecules are combined before the transform is applied.

Makes a sequence of reaction objects where the given molecule(s) form one side of each reaction, and the molecules resulting from the application of the transform form the other side. If 'som' is a sequence of molecules, all of the molecules in the sequence will appear in each reaction which results from the transform. The answer set will contain only reactions with a unique set of atoms relative to all other matching reactions in the answerset.

The 'direction' can be either of DX_FORWARD or DX_REVERSE. If DX_FORWARD, the given molecules are reactants and the transformed molecules are products in the resulting reactions. If DX_REVERSE, the given molecules are products and the transformed molecules are reactants in the resulting reactions.

If 'limit' is 1, the first legal reaction found is returned. Otherwise, returns the exhaustive list of reactions found.

Return Value

Returns a sequence of reactions or NULL_OB if an error is detected. Each reaction will have a complete atom map, except for atoms which are added or deleted during the reaction. The atoms in the reactions have an the integer properties "tmap" and "torder" set (see dt_integer(3)) for any atom which was matched by the transform atom expressions. The property "tmap" is the atom map class of the SMIRKS for the matching atomic expression. The property "torder" is the match order of nodes from the original transform, numbered from 1.

Related Topics

dt_pattern(3) dt_smirkin(3) dt_umatch(3)