This file is indexed.

/usr/share/doc/libstarlink-ast-doc/node70.html is in libstarlink-ast-doc 8.6.2+dfsg-2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  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
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<!--Converted with LaTeX2HTML 2008 (1.71)
original version by:  Nikos Drakos, CBLU, University of Leeds
* revised and updated by:  Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
  Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>Simplifying Compound Mappings</TITLE>
<META NAME="description" CONTENT="Simplifying Compound Mappings">
<META NAME="keywords" CONTENT="sun211">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">

<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">

<LINK REL="STYLESHEET" HREF="sun211.css">

<LINK REL="previous" HREF="node69.html">
<LINK REL="up" HREF="node63.html">
<LINK REL="next" HREF="node71.html">
</HEAD>

<BODY >

<DIV CLASS="navigation"><!--Navigation Panel-->
<A NAME="tex2html1141"
  HREF="node71.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next"
 SRC="/usr/share/latex2html/icons/next.png"></A> 
<A NAME="tex2html1139"
  HREF="node63.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up"
 SRC="/usr/share/latex2html/icons/up.png"></A> 
<A NAME="tex2html1135"
  HREF="node69.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous"
 SRC="/usr/share/latex2html/icons/prev.png"></A>   
<BR>
<B> Next:</B> <A NAME="tex2html1142"
  HREF="node71.html">Representing Coordinate Systems (Frames)</A>
<B> Up:</B> <A NAME="tex2html1140"
  HREF="node63.html">Compound Mappings (CmpMaps)</A>
<B> Previous:</B> <A NAME="tex2html1136"
  HREF="node69.html">Over-Complex Compound Mappings</A>
<BR>
<BR></DIV>
<!--End of Navigation Panel-->

<H2><A NAME="SECTION00067000000000000000"></A><A NAME="ss:simplifyingcmpmaps"></A>
<BR>
Simplifying Compound Mappings
</H2>

<P>
The ability to simplify compound Mappings is provided by the
astSimplifyastSimplify function. This function encapsulates a number of
heuristics for converting Mappings, or combinations of Mappings within
a CmpMapCmpMap, into simpler, equivalent ones. When applied to a CmpMap,
astSimplify tries to reduce the number of individual Mappings within
it by merging neighbouring component Mappings together. It will do
this with both series and parallel combinations of Mappings, or both,
and will handle CmpMaps nested to any depth
(&#167;<A HREF="node67.html#ss:complexcmpmap">6.4</A>).

<P>
To illustrate how astSimplify works, consider the combination of
   Mappings shown in Figure&nbsp;<A HREF="#fig:simplifyexample">10</A>.
   
<DIV ALIGN="CENTER"><A NAME="fig:simplifyexample"></A><A NAME="22083"></A>
<TABLE>
<CAPTION ALIGN="BOTTOM"><STRONG>Figure 10:</STRONG>
An over-complex compound Mapping, consisting of PermMaps,
   ZoomMaps and a UnitMapUnitMap, which can be simplified to become a single
   UnitMap.  The enclosing nested CmpMaps have been omitted for clarity.</CAPTION>
<TR><TD>
<DIV ALIGN="CENTER">
[width=0.7]sun211_figures/simpexamp
   
</DIV></TD></TR>
</TABLE>
</DIV>

<P>
If this were contained in a CmpMap, it could be simplified as follows:

<P>
<SMALL CLASS="SMALL">
<BR>
<IMG
 WIDTH="265" HEIGHT="91" ALIGN="BOTTOM" BORDER="0"
 SRC="img98.png"
 ALT="\begin{terminalv}
AstMapping *simpler;
\par
...
\par
simpler = astSimplify( cmpmap );
\end{terminalv}">
<BR>
</SMALL>
<P>
In this case, the result would be a simple 3-dimensional UnitMap (the
identity MappingMapping).  To reach this conclusion, astSimplify will have
made a number of deductions, roughly as follows:

<P>

<OL>
<LI>The two 2-dimensional ZoomMaps in series are equivalent to a
single ZoomMapZoomMap with a combined ZoomZoom factor of unity. This, in turn, is
equivalent to a 2-dimensional UnitMap.

<P>
</LI>
<LI>This UnitMap in parallel with the other 1-dimensional UnitMap is
equivalent to a single 3-dimensional UnitMap. This UnitMap, sandwiched
between any other pair of Mappings, can then be eliminated.

<P>
</LI>
<LI>The remaining two PermMaps in series are equivalent to a single
3-dimensional PermMapPermMap. When these are combined, the resulting PermMap
is found to be equivalent to a 3-dimensional UnitMap.
</LI>
</OL>

<P>
This example is a little contrived, but illustrates how astSimplify
can deal with even quite complicated compound Mappings through a
series of incremental simplifications. Where possible, this will
result in either a simpler compound Mapping or, if feasible, an atomic
(non-compound) Mapping, as here. If no simplification is possible,
astSimplify will just return a pointer to the original Mapping.

<P>
Although astSimplify cannot identify every simplification that is
theoretically possible, sufficient rules are included to deal with the
most common and important cases.

<P>

<DIV CLASS="navigation"><HR>
<!--Navigation Panel-->
<A NAME="tex2html1141"
  HREF="node71.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next"
 SRC="/usr/share/latex2html/icons/next.png"></A> 
<A NAME="tex2html1139"
  HREF="node63.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up"
 SRC="/usr/share/latex2html/icons/up.png"></A> 
<A NAME="tex2html1135"
  HREF="node69.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous"
 SRC="/usr/share/latex2html/icons/prev.png"></A>   
<BR>
<B> Next:</B> <A NAME="tex2html1142"
  HREF="node71.html">Representing Coordinate Systems (Frames)</A>
<B> Up:</B> <A NAME="tex2html1140"
  HREF="node63.html">Compound Mappings (CmpMaps)</A>
<B> Previous:</B> <A NAME="tex2html1136"
  HREF="node69.html">Over-Complex Compound Mappings</A></DIV>
<!--End of Navigation Panel-->

</BODY>
</HTML>