doc-exports/docs/dws/dev/dws_06_0315.html
Lu, Huayi e6fa411af0 DWS DEV 830.201 version
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Co-authored-by: Lu, Huayi <luhuayi@huawei.com>
Co-committed-by: Lu, Huayi <luhuayi@huawei.com>
2024-05-16 07:24:04 +00:00

219 lines
20 KiB
HTML

<a name="EN-US_TOPIC_0000001443287400"></a><a name="EN-US_TOPIC_0000001443287400"></a>
<h1 class="topictitle1">Geometric Functions</h1>
<div id="body0000001443287400"><div class="section" id="EN-US_TOPIC_0000001443287400__sad91473ed32041fdb6b070ac990f4eec"><h4 class="sectiontitle">area(object)</h4><p id="EN-US_TOPIC_0000001443287400__a9f40142803ff497081044a0fa8da581e">Description: Area calculation</p>
<p id="EN-US_TOPIC_0000001443287400__a9617692b11894566820c898ffb09a6dc">Return type: double precision</p>
<p id="EN-US_TOPIC_0000001443287400__aaf9c74b24213426aaa82b048fd7e828b">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001443287400__sb529351ff0f744c3a7db1ed0ec95461f"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">area</span><span class="p">(</span><span class="n">box</span><span class="w"> </span><span class="s1">'((0,0),(1,1))'</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">--------</span>
<span class="w"> </span><span class="mi">1</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001443287400__section862165611451"><h4 class="sectiontitle">center(object)</h4><p id="EN-US_TOPIC_0000001443287400__p1155156164515">Description: Figure center calculation</p>
<p id="EN-US_TOPIC_0000001443287400__p65515612450">Return type: point</p>
<p id="EN-US_TOPIC_0000001443287400__p1655115664520">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001443287400__screen15616567453"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">center</span><span class="p">(</span><span class="n">box</span><span class="w"> </span><span class="s1">'((0,0),(1,2))'</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">---------</span>
<span class="w"> </span><span class="p">(</span><span class="mi">0</span><span class="p">.</span><span class="mi">5</span><span class="p">,</span><span class="mi">1</span><span class="p">)</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001443287400__section5842022134611"><h4 class="sectiontitle">diameter(circle)</h4><p id="EN-US_TOPIC_0000001443287400__p877162264618">Description: Circle diameter calculation</p>
<p id="EN-US_TOPIC_0000001443287400__p1377522174610">Return type: double precision</p>
<p id="EN-US_TOPIC_0000001443287400__p1077172211460">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001443287400__screen107710227461"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">diameter</span><span class="p">(</span><span class="n">circle</span><span class="w"> </span><span class="s1">'((0,0),2.0)'</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">--------</span>
<span class="w"> </span><span class="mi">4</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001443287400__section165313216475"><h4 class="sectiontitle">height(box)</h4><p id="EN-US_TOPIC_0000001443287400__p1265222114714">Description: Vertical size of box</p>
<p id="EN-US_TOPIC_0000001443287400__p2065218234719">Return type: double precision</p>
<p id="EN-US_TOPIC_0000001443287400__p156523294716">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001443287400__screen1065282204713"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">height</span><span class="p">(</span><span class="n">box</span><span class="w"> </span><span class="s1">'((0,0),(1,1))'</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">--------</span>
<span class="w"> </span><span class="mi">1</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001443287400__section151817198476"><h4 class="sectiontitle">isclosed(path)</h4><p id="EN-US_TOPIC_0000001443287400__p1817971954712">Description: A closed path?</p>
<p id="EN-US_TOPIC_0000001443287400__p2018081915472">Return type: <span id="EN-US_TOPIC_0000001443287400__text151792019194715">boolean</span></p>
<p id="EN-US_TOPIC_0000001443287400__p111801419124717">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001443287400__screen1318061916479"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">isclosed</span><span class="p">(</span><span class="n">path</span><span class="w"> </span><span class="s1">'((0,0),(1,1),(2,0))'</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">--------</span>
<span class="w"> </span><span class="n">t</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001443287400__section873294017472"><h4 class="sectiontitle">isopen(path)</h4><p id="EN-US_TOPIC_0000001443287400__p373134019479">Description: An open path?</p>
<p id="EN-US_TOPIC_0000001443287400__p2731740174712">Return type: <span id="EN-US_TOPIC_0000001443287400__text1673111406475">boolean</span></p>
<p id="EN-US_TOPIC_0000001443287400__p57311540174711">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001443287400__screen19732940104718"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">isopen</span><span class="p">(</span><span class="n">path</span><span class="w"> </span><span class="s1">'[(0,0),(1,1),(2,0)]'</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">--------</span>
<span class="w"> </span><span class="n">t</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001443287400__section159261917104815"><h4 class="sectiontitle">length(object)</h4><p id="EN-US_TOPIC_0000001443287400__p186841434174612">Description: Length calculation</p>
<p id="EN-US_TOPIC_0000001443287400__p768573434615">Return type: double precision</p>
<p id="EN-US_TOPIC_0000001443287400__p868519348465">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001443287400__screen468563444619"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">length</span><span class="p">(</span><span class="n">path</span><span class="w"> </span><span class="s1">'((-1,0),(1,0))'</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">--------</span>
<span class="w"> </span><span class="mi">4</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001443287400__section940093414814"><h4 class="sectiontitle">npoints(path)</h4><p id="EN-US_TOPIC_0000001443287400__p66851834164618">Description: Number of points in path</p>
<p id="EN-US_TOPIC_0000001443287400__p166855345468">Return type: int</p>
<p id="EN-US_TOPIC_0000001443287400__p2068573464611">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001443287400__screen6685834104615"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">npoints</span><span class="p">(</span><span class="n">path</span><span class="w"> </span><span class="s1">'[(0,0),(1,1),(2,0)]'</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">--------</span>
<span class="w"> </span><span class="mi">3</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001443287400__section1180345124811"><h4 class="sectiontitle">npoints(polygon)</h4><p id="EN-US_TOPIC_0000001443287400__p8685734124612">Description: Number of points in polygon</p>
<p id="EN-US_TOPIC_0000001443287400__p19686434174619">Return type: int</p>
<p id="EN-US_TOPIC_0000001443287400__p166861734124619">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001443287400__screen196861342464"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">npoints</span><span class="p">(</span><span class="n">polygon</span><span class="w"> </span><span class="s1">'((1,1),(0,0))'</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">--------</span>
<span class="w"> </span><span class="mi">2</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001443287400__section842115424810"><h4 class="sectiontitle">pclose(path)</h4><p id="EN-US_TOPIC_0000001443287400__p2686734204611">Description: Converts path to closed.</p>
<p id="EN-US_TOPIC_0000001443287400__p56861934104610">Return type: path</p>
<p id="EN-US_TOPIC_0000001443287400__p7686183411463">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001443287400__screen268663412461"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">pclose</span><span class="p">(</span><span class="n">path</span><span class="w"> </span><span class="s1">'[(0,0),(1,1),(2,0)]'</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="p">((</span><span class="mi">0</span><span class="p">,</span><span class="mi">0</span><span class="p">),(</span><span class="mi">1</span><span class="p">,</span><span class="mi">1</span><span class="p">),(</span><span class="mi">2</span><span class="p">,</span><span class="mi">0</span><span class="p">))</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001443287400__section39877418499"><h4 class="sectiontitle">popen(path)</h4><p id="EN-US_TOPIC_0000001443287400__p1968723412463">Description: Converts path to open.</p>
<p id="EN-US_TOPIC_0000001443287400__p5687193416461">Return type: path</p>
<p id="EN-US_TOPIC_0000001443287400__p968753474614">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001443287400__screen1368793412468"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">popen</span><span class="p">(</span><span class="n">path</span><span class="w"> </span><span class="s1">'((0,0),(1,1),(2,0))'</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="p">[(</span><span class="mi">0</span><span class="p">,</span><span class="mi">0</span><span class="p">),(</span><span class="mi">1</span><span class="p">,</span><span class="mi">1</span><span class="p">),(</span><span class="mi">2</span><span class="p">,</span><span class="mi">0</span><span class="p">)]</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001443287400__section1691613894911"><h4 class="sectiontitle">radius(circle)</h4><p id="EN-US_TOPIC_0000001443287400__p1568718349461">Description: Circle diameter calculation</p>
<p id="EN-US_TOPIC_0000001443287400__p768813342469">Return type: double precision</p>
<p id="EN-US_TOPIC_0000001443287400__p6688183420467">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001443287400__screen068813418464"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">radius</span><span class="p">(</span><span class="n">circle</span><span class="w"> </span><span class="s1">'((0,0),2.0)'</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">--------</span>
<span class="w"> </span><span class="mi">2</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001443287400__section79210228495"><h4 class="sectiontitle">width(box)</h4><p id="EN-US_TOPIC_0000001443287400__p76881834144614">Description: Horizontal size of box</p>
<p id="EN-US_TOPIC_0000001443287400__p46882343465">Return type: double precision</p>
<p id="EN-US_TOPIC_0000001443287400__p1568883410461">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001443287400__screen96891434194612"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">width</span><span class="p">(</span><span class="n">box</span><span class="w"> </span><span class="s1">'((0,0),(1,1))'</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">--------</span>
<span class="w"> </span><span class="mi">1</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_06_0037.html">Geometric Functions and Operators</a></div>
</div>
</div>