File: modify_scope.html

package info (click to toggle)
gamgi 0.17.5-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 21,236 kB
  • sloc: ansic: 166,847; xml: 116,171; makefile: 565; sh: 5
file content (140 lines) | stat: -rw-r--r-- 4,459 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">

<head>
<title>GAMGI Interfaces: Group Modify</title>
<link rel="icon" type="image/png" href="../../icon/gamgi16.png"/>
<link rel="stylesheet" type="text/css" href="../../css/base.css"/>
<link rel="stylesheet" type="text/css" href="../../css/notebook.css"/>
</head>

<body>

<h1>Group Modify</h1>

<div id="notebook">
<ul>
<li><a href="modify_type.html">Type</a></li>
<li><span>Scope</span></li>
<li><a href="modify_tolerance.html">Tolerance</a></li>
<li><a href="modify_view.html">View</a></li>
</ul>
</div>

<div class="contents">
            
Change here the polytope representation and atomic structure for a single group or a list of groups.

<p/>

To modify a group, click over its graphic image, or write its identification
(name and number) on the <b>Group</b> entry. To modify a list of groups,
press the button <b>List</b> (after creating the list of groups with
<b>Group->Select</b>).  Parameters for empty entries or <b>Local</b>
choices remain unchanged.

<p/>

To change a group name write the new name in the <b>Group</b> entry,
followed by the group number (GAMGI needs the number to identify the group).
To change the name for a list of groups, press <b>List</b> first
and then write the new common name in the <b>Name</b> entry.

<h3>Structure</h3>

It is often useful to recreate in a group the atomic
structure existing in the parent object. For each coordination
polyhedron, this includes all the atoms defining the polyhedron
vertices, plus the central atom.

<p/>

When <b>Structure</b> is set to <b>Copy</b>, atoms
are copied to the groups just created.

When <b>Structure</b> is set to <b>Link</b>, atoms
are linked to the groups just created.

When <b>Structure</b> is set to <b>None</b>, atoms
are ignored.

<h3>Filter</h3>

After collecting a list of atoms close enough to the group,
a filtering condition may be applied. This can be very useful
to avoid atom superposition, resulting for example from atoms
copied before to different groups.

<p/>

When <b>Filter</b> is set to <b>Class</b>,
atoms belonging to another groups are ignored.

When <b>Filter</b> is set to <b>Child</b>, atoms not
belonging directly to the group parent are ignored.

When <b>Filter</b> is set to <b>Identical</b>, atoms
closer than a given distance (currently <b>1.0E-2</b>,
as defined in <b>GAMGI_MATH_TOLERANCE_STRUCTURE</b>) to
a previous atom are ignored.

When <b>Filter</b> is set to <b>None</b>, no filtering
condition is applied.

<h3>Visible</h3>

When the mix product of four vertices (defining a face and a new vertex),
is larger than <b>Visible</b> the face is visible from the vertex and
must be replaced. Increasing <b>Visible</b> may reduce face reconstruction,
but may result in numerical inaccuracies. The whole calculation is very
sensitive to this parameter, so it should be handled carefully. Currently
the maximum allowed value is <b>1.0E-5</b>.

<p/>

For complex systems, where different faces have almost the same orientation,
forming curved surfaces, setting <b>Visible</b> to <b>0</b> might eliminate
numerical errors.

<h3>Coplanar</h3>

The initial triangle faces are merged when the mix product
of four vertices (belonging to both faces) is smaller than
<b>Coplanar</b>. Increasing <b>Coplanar</b> promotes face merging,
but may result in numerical inaccuracies. Currently the maximum
allowed value is <b>1.0E-1</b>.

<p/>

Setting <b>Coplanar</b> to <b>0</b> disables face merging,
so all faces will be triangles.

<h3>Neighbours</h3>

Set here the neighbour atoms that should be considered around each central atom.
The sampling universe is always the object currently selected. When the
central atom does not belong to the current object, an error is shown.

<p/>

<b>Element</b> defines the atomic element of the neighbours that should 
be considered. When <b>Element</b> is empty (the default), all atomic 
elements will be considered.

<p/>

Users can set the number of closest neighbours that should be considered
using <b>Number</b>, or the radius of the sphere around the central
atom that should be sampled, using <b>Radius</b>. When these are empty 
(the default), all atoms in the sampling universe will be considered.

</div>

<div id="bottom">
<a href="../../index.shtml">Home</a>
</div>

</body>
</html>