blob: 4188f8cca1104dee4e91d06e35c383b5ad1ddfaf (
plain)
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
|
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<!--
* This file is part of the LibreOffice project.
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*
* This file incorporates work covered by the following license notice:
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed
* with this work for additional information regarding copyright
* ownership. The ASF licenses this file to you under the Apache
* License, Version 2.0 (the "License"); you may not use this file
* except in compliance with the License. You may obtain a copy of
* the License at http://www.apache.org/licenses/LICENSE-2.0 .
-->
<meta>
<topic id="textsbasicshared03080101xml" indexer="include" status="PUBLISH">
<title id="tit" xml-lang="en-US">Atn Function</title>
<filename>/text/sbasic/shared/03080101.xhp</filename>
</topic>
</meta>
<body>
<section id="atn">
<bookmark xml-lang="en-US" branch="index" id="bm_id3150616">
<bookmark_value>Atn function</bookmark_value>
</bookmark>
<h1 id="hd_id3150616"><variable id="Atn_h1"><link href="text/sbasic/shared/03080101.xhp" name="Atn Function">Atn Function</link></variable></h1>
<paragraph id="par_id3149346" role="paragraph">Trigonometric function that returns the arctangent of a numeric expression. The return value is in the range -Pi/2 to +Pi/2.</paragraph>
</section>
<paragraph id="par_id3143271" role="paragraph" xml-lang="en-US">The arctangent is the inverse of the tangent function. The <literal>Atn</literal> Function returns the angle "Alpha", expressed in radians, using the tangent of this angle. The function can also return the angle "Alpha" by comparing the ratio of the length of the side that is opposite of the angle to the length of the side that is adjacent to the angle in a right-angled triangle.</paragraph>
<paragraph id="par_id3145315" role="paragraph" xml-lang="en-US"><literal>Atn</literal>(side opposite the angle/side adjacent to angle)= Alpha</paragraph>
<embed href="text/sbasic/shared/00000003.xhp#functsyntax"/>
<bascode>
<paragraph id="par_id3148947" role="bascode" xml-lang="en-US">Atn (Number As Double) As Double</paragraph>
</bascode>
<embed href="text/sbasic/shared/00000003.xhp#functvalue"/>
<paragraph id="par_id3150359" localize="false" role="paragraph">Double</paragraph>
<embed href="text/sbasic/shared/00000003.xhp#functparameters"/>
<paragraph id="par_id3156212" role="paragraph" xml-lang="en-US"> <emph>Number:</emph> Any numerical expression that represents the ratio of two sides of a right triangle. The <literal>Atn</literal> function returns the corresponding angle in radians (arctangent).</paragraph>
<paragraph id="par_id3153192" role="paragraph" xml-lang="en-US">To convert radians to degrees, multiply radians by 180/pi.</paragraph>
<paragraph id="par_id3147230" role="paragraph" xml-lang="en-US">degree=(radian*180)/pi</paragraph>
<paragraph id="par_id3125864" role="paragraph" xml-lang="en-US">radian=(degree*pi)/180</paragraph>
<paragraph id="par_id3159252" role="paragraph" xml-lang="en-US"><literal>Pi</literal> is here the fixed circle constant with the rounded value 3.14159. <literal>Pi</literal> is a <link href="text/sbasic/shared/03040000.xhp#mathconstants" name="pi">Basic mathematical constant</link>.</paragraph>
<embed href="text/sbasic/shared/00000003.xhp#errorcode"/>
<embed href="text/sbasic/shared/00000003.xhp#err5"/>
<embed href="text/sbasic/shared/00000003.xhp#functexample"/>
<bascode>
<paragraph id="par_id3146985" role="bascode" xml-lang="en-US">' The following example calculates for a right-angled triangle</paragraph>
<paragraph id="par_id3145750" role="bascode" xml-lang="en-US">' the angle Alpha from the tangent of the angle Alpha:</paragraph>
<paragraph id="par_idm1340870576" role="bascode" localize="false">Sub ExampleAtn</paragraph>
<paragraph id="par_id3151112" role="bascode" xml-lang="en-US">' rounded Pi = 3.14159 Is a predefined constant</paragraph>
<paragraph id="par_idm1340867552" role="bascode" localize="false">Dim d1 As Double</paragraph>
<paragraph id="par_idm1340866320" role="bascode" localize="false">Dim d2 As Double</paragraph>
<paragraph id="par_id3149262" role="bascode" xml-lang="en-US"> d1 = InputBox("Enter the length of the side adjacent to the angle: ","Adjacent")</paragraph>
<paragraph id="par_id3149482" role="bascode" xml-lang="en-US"> d2 = InputBox("Enter the length of the side opposite the angle: ","Opposite")</paragraph>
<paragraph id="par_id3155415" role="bascode" xml-lang="en-US"> Print "The Alpha angle is"; (atn (d2/d1) * 180 / Pi); " degrees"</paragraph>
<paragraph id="par_idm1340859728" role="bascode" localize="false">End Sub</paragraph>
</bascode>
<section id="relatedtopics">
<embed href="text/sbasic/shared/03080102.xhp#Cos_h1"/>
<embed href="text/sbasic/shared/03080103.xhp#Sin_h1"/>
<embed href="text/sbasic/shared/03080104.xhp#Tan_h1"/>
</section>
</body>
</helpdocument>
|
