summaryrefslogtreecommitdiff
path: root/modules/elementary_functions/macros/cosh.sci
blob: acbaf8ebe18d25ad0a9276ba06ad0a8d5484eccb (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
// Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
// Copyright (C) INRIA
//
// This file must be used under the terms of the CeCILL.
// This source file is licensed as described in the file COPYING, which
// you should have received as part of this distribution.  The terms
// are also available at
// http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt

function [t] = cosh(z)
    //
    //  PURPOSE
    //     element wise hyperbolic cosinus
    //
    //  METHOD
    //     1/ in the real case use
    //
    //         cosh(z) = 0.5 (exp(|z|) + exp(-|z|))
    //                 = 0.5 ( y + 1/y ) with y = exp(|z|)
    //
    //         The absolute value avoids the problem of a
    //         division by zero arising with the formula
    //           "cosh(z) = 0.5 ( y + 1/y ), y=exp(z)"
    //         when ieee = 0 for z such that exp(z) equal 0
    //         in floating point arithmetic ( approximatly z < -745 )
    //
    //     2/ in the complex case use :   cosh(z) = cos(i z)
    //

    rhs = argn(2);

    if rhs <> 1 then
        error(msprintf(gettext("%s: Wrong number of input argument(s): %d expected.\n"),"cosh",1));
    end

    if type(z)<>1 then
        error(msprintf(gettext("%s: Wrong type for input argument #%d: Real or complex matrix expected.\n"),"cosh",1));
    end

    if isreal(z) then
        y = exp(abs(z)) ; t = 0.5*(y + 1 ./y)
    else
        t = cos(imult(z))
    end

endfunction