blob: b961ca8f1a73fa42b8c3ad88214772c1abe2760c [file] [log] [blame]
Guido van Rossum71aa32f1996-01-12 01:34:57 +00001/* Complex math module */
2
3/* much code borrowed from mathmodule.c */
4
Roger E. Masse24070ca1996-12-09 22:59:53 +00005#include "Python.h"
Guido van Rossum71aa32f1996-01-12 01:34:57 +00006
Guido van Rossum71aa32f1996-01-12 01:34:57 +00007#ifdef i860
8/* Cray APP has bogus definition of HUGE_VAL in <math.h> */
9#undef HUGE_VAL
10#endif
11
12#ifdef HUGE_VAL
13#define CHECK(x) if (errno != 0) ; \
14 else if (-HUGE_VAL <= (x) && (x) <= HUGE_VAL) ; \
15 else errno = ERANGE
16#else
17#define CHECK(x) /* Don't know how to check */
18#endif
19
20#ifndef M_PI
21#define M_PI (3.141592653589793239)
22#endif
23
24/* First, the C functions that do the real work */
25
26/* constants */
Tim Peters8cb82bd2001-02-20 20:36:38 +000027static Py_complex c_one = {1., 0.};
Guido van Rossum9e720e31996-07-21 02:31:35 +000028static Py_complex c_half = {0.5, 0.};
29static Py_complex c_i = {0., 1.};
Tim Peters8cb82bd2001-02-20 20:36:38 +000030static Py_complex c_halfi = {0., 0.5};
Guido van Rossum71aa32f1996-01-12 01:34:57 +000031
32/* forward declarations */
Thomas Wouterseb61b6e2000-07-24 11:17:40 +000033staticforward Py_complex c_log(Py_complex);
34staticforward Py_complex c_prodi(Py_complex);
35staticforward Py_complex c_sqrt(Py_complex);
Guido van Rossum71aa32f1996-01-12 01:34:57 +000036
37
Tim Peters14e26402001-02-20 20:15:19 +000038static Py_complex
39c_acos(Py_complex x)
Guido van Rossum71aa32f1996-01-12 01:34:57 +000040{
41 return c_neg(c_prodi(c_log(c_sum(x,c_prod(c_i,
Tim Peters8cb82bd2001-02-20 20:36:38 +000042 c_sqrt(c_diff(c_one,c_prod(x,x))))))));
Guido van Rossum71aa32f1996-01-12 01:34:57 +000043}
44
Tim Peters14e26402001-02-20 20:15:19 +000045static char c_acos_doc[] =
46"acos(x)\n"
47"\n"
48"Return the arc cosine of x.";
Guido van Rossumc6e22901998-12-04 19:26:43 +000049
50
Tim Peters14e26402001-02-20 20:15:19 +000051static Py_complex
52c_acosh(Py_complex x)
Guido van Rossum71aa32f1996-01-12 01:34:57 +000053{
Guido van Rossumf385c5e2000-06-30 02:29:22 +000054 Py_complex z;
55 z = c_sqrt(c_half);
Tim Peters8cb82bd2001-02-20 20:36:38 +000056 z = c_log(c_prod(z, c_sum(c_sqrt(c_sum(x,c_one)),
57 c_sqrt(c_diff(x,c_one)))));
Guido van Rossumf385c5e2000-06-30 02:29:22 +000058 return c_sum(z, z);
Guido van Rossum71aa32f1996-01-12 01:34:57 +000059}
60
Tim Peters14e26402001-02-20 20:15:19 +000061static char c_acosh_doc[] =
62"acosh(x)\n"
63"\n"
64"Return the hyperbolic arccosine of x.";
Guido van Rossumc6e22901998-12-04 19:26:43 +000065
66
Tim Peters14e26402001-02-20 20:15:19 +000067static Py_complex
68c_asin(Py_complex x)
Guido van Rossum71aa32f1996-01-12 01:34:57 +000069{
Tim Petersedf22102001-02-21 03:22:39 +000070 /* -i * log[(sqrt(1-x**2) + i*x] */
71 const Py_complex squared = c_prod(x, x);
72 const Py_complex sqrt_1_minus_x_sq = c_sqrt(c_diff(c_one, squared));
73 const Py_complex sum = c_sum(sqrt_1_minus_x_sq, c_prod(c_i, x));
74 return c_neg(c_prodi(c_log(sum)));
Guido van Rossum71aa32f1996-01-12 01:34:57 +000075}
76
Tim Peters14e26402001-02-20 20:15:19 +000077static char c_asin_doc[] =
78"asin(x)\n"
79"\n"
80"Return the arc sine of x.";
Guido van Rossumc6e22901998-12-04 19:26:43 +000081
82
Tim Peters14e26402001-02-20 20:15:19 +000083static Py_complex
84c_asinh(Py_complex x)
Guido van Rossum71aa32f1996-01-12 01:34:57 +000085{
Guido van Rossum11a50711999-01-14 19:11:11 +000086 Py_complex z;
Tim Petersedf22102001-02-21 03:22:39 +000087 z = c_sqrt(c_half);
88 z = c_log(c_prod(z, c_sum(c_sqrt(c_sum(x, c_i)),
89 c_sqrt(c_diff(x, c_i)))));
90 return c_sum(z, z);
Guido van Rossum71aa32f1996-01-12 01:34:57 +000091}
92
Tim Peters14e26402001-02-20 20:15:19 +000093static char c_asinh_doc[] =
94"asinh(x)\n"
95"\n"
96"Return the hyperbolic arc sine of x.";
Guido van Rossumc6e22901998-12-04 19:26:43 +000097
98
Tim Peters14e26402001-02-20 20:15:19 +000099static Py_complex
100c_atan(Py_complex x)
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000101{
Tim Peters8cb82bd2001-02-20 20:36:38 +0000102 return c_prod(c_halfi,c_log(c_quot(c_sum(c_i,x),c_diff(c_i,x))));
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000103}
104
Tim Peters14e26402001-02-20 20:15:19 +0000105static char c_atan_doc[] =
106"atan(x)\n"
107"\n"
108"Return the arc tangent of x.";
Guido van Rossumc6e22901998-12-04 19:26:43 +0000109
110
Tim Peters14e26402001-02-20 20:15:19 +0000111static Py_complex
112c_atanh(Py_complex x)
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000113{
Tim Peters8cb82bd2001-02-20 20:36:38 +0000114 return c_prod(c_half,c_log(c_quot(c_sum(c_one,x),c_diff(c_one,x))));
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000115}
116
Tim Peters14e26402001-02-20 20:15:19 +0000117static char c_atanh_doc[] =
118"atanh(x)\n"
119"\n"
120"Return the hyperbolic arc tangent of x.";
Guido van Rossumc6e22901998-12-04 19:26:43 +0000121
122
Tim Peters14e26402001-02-20 20:15:19 +0000123static Py_complex
124c_cos(Py_complex x)
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000125{
Guido van Rossum9e720e31996-07-21 02:31:35 +0000126 Py_complex r;
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000127 r.real = cos(x.real)*cosh(x.imag);
128 r.imag = -sin(x.real)*sinh(x.imag);
129 return r;
130}
131
Tim Peters14e26402001-02-20 20:15:19 +0000132static char c_cos_doc[] =
133"cos(x)\n"
134"n"
135"Return the cosine of x.";
Guido van Rossumc6e22901998-12-04 19:26:43 +0000136
137
Tim Peters14e26402001-02-20 20:15:19 +0000138static Py_complex
139c_cosh(Py_complex x)
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000140{
Guido van Rossum9e720e31996-07-21 02:31:35 +0000141 Py_complex r;
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000142 r.real = cos(x.imag)*cosh(x.real);
143 r.imag = sin(x.imag)*sinh(x.real);
144 return r;
145}
146
Tim Peters14e26402001-02-20 20:15:19 +0000147static char c_cosh_doc[] =
148"cosh(x)\n"
149"n"
150"Return the hyperbolic cosine of x.";
Guido van Rossumc6e22901998-12-04 19:26:43 +0000151
152
Tim Peters14e26402001-02-20 20:15:19 +0000153static Py_complex
154c_exp(Py_complex x)
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000155{
Guido van Rossum9e720e31996-07-21 02:31:35 +0000156 Py_complex r;
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000157 double l = exp(x.real);
158 r.real = l*cos(x.imag);
159 r.imag = l*sin(x.imag);
160 return r;
161}
162
Tim Peters14e26402001-02-20 20:15:19 +0000163static char c_exp_doc[] =
164"exp(x)\n"
165"\n"
166"Return the exponential value e**x.";
Guido van Rossumc6e22901998-12-04 19:26:43 +0000167
168
Tim Peters14e26402001-02-20 20:15:19 +0000169static Py_complex
170c_log(Py_complex x)
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000171{
Guido van Rossum9e720e31996-07-21 02:31:35 +0000172 Py_complex r;
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000173 double l = hypot(x.real,x.imag);
174 r.imag = atan2(x.imag, x.real);
175 r.real = log(l);
176 return r;
177}
178
Tim Peters14e26402001-02-20 20:15:19 +0000179static char c_log_doc[] =
180"log(x)\n"
181"\n"
182"Return the natural logarithm of x.";
Guido van Rossumc6e22901998-12-04 19:26:43 +0000183
184
Tim Peters14e26402001-02-20 20:15:19 +0000185static Py_complex
186c_log10(Py_complex x)
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000187{
Guido van Rossum9e720e31996-07-21 02:31:35 +0000188 Py_complex r;
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000189 double l = hypot(x.real,x.imag);
190 r.imag = atan2(x.imag, x.real)/log(10.);
191 r.real = log10(l);
192 return r;
193}
194
Tim Peters14e26402001-02-20 20:15:19 +0000195static char c_log10_doc[] =
196"log10(x)\n"
197"\n"
198"Return the base-10 logarithm of x.";
Guido van Rossumc6e22901998-12-04 19:26:43 +0000199
200
201/* internal function not available from Python */
Tim Peters14e26402001-02-20 20:15:19 +0000202static Py_complex
203c_prodi(Py_complex x)
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000204{
Guido van Rossum9e720e31996-07-21 02:31:35 +0000205 Py_complex r;
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000206 r.real = -x.imag;
207 r.imag = x.real;
208 return r;
209}
210
Guido van Rossumc6e22901998-12-04 19:26:43 +0000211
Tim Peters14e26402001-02-20 20:15:19 +0000212static Py_complex
213c_sin(Py_complex x)
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000214{
Guido van Rossum9e720e31996-07-21 02:31:35 +0000215 Py_complex r;
Tim Peters14e26402001-02-20 20:15:19 +0000216 r.real = sin(x.real) * cosh(x.imag);
217 r.imag = cos(x.real) * sinh(x.imag);
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000218 return r;
219}
220
Tim Peters14e26402001-02-20 20:15:19 +0000221static char c_sin_doc[] =
222"sin(x)\n"
223"\n"
224"Return the sine of x.";
Guido van Rossumc6e22901998-12-04 19:26:43 +0000225
226
Tim Peters14e26402001-02-20 20:15:19 +0000227static Py_complex
228c_sinh(Py_complex x)
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000229{
Guido van Rossum9e720e31996-07-21 02:31:35 +0000230 Py_complex r;
Tim Peters14e26402001-02-20 20:15:19 +0000231 r.real = cos(x.imag) * sinh(x.real);
232 r.imag = sin(x.imag) * cosh(x.real);
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000233 return r;
234}
235
Tim Peters14e26402001-02-20 20:15:19 +0000236static char c_sinh_doc[] =
237"sinh(x)\n"
238"\n"
239"Return the hyperbolic sine of x.";
Guido van Rossumc6e22901998-12-04 19:26:43 +0000240
241
Tim Peters14e26402001-02-20 20:15:19 +0000242static Py_complex
243c_sqrt(Py_complex x)
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000244{
Guido van Rossum9e720e31996-07-21 02:31:35 +0000245 Py_complex r;
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000246 double s,d;
247 if (x.real == 0. && x.imag == 0.)
248 r = x;
249 else {
250 s = sqrt(0.5*(fabs(x.real) + hypot(x.real,x.imag)));
251 d = 0.5*x.imag/s;
252 if (x.real > 0.) {
253 r.real = s;
254 r.imag = d;
255 }
256 else if (x.imag >= 0.) {
257 r.real = d;
258 r.imag = s;
259 }
260 else {
261 r.real = -d;
262 r.imag = -s;
263 }
264 }
265 return r;
266}
267
Tim Peters14e26402001-02-20 20:15:19 +0000268static char c_sqrt_doc[] =
269"sqrt(x)\n"
270"\n"
271"Return the square root of x.";
Guido van Rossumc6e22901998-12-04 19:26:43 +0000272
273
Tim Peters14e26402001-02-20 20:15:19 +0000274static Py_complex
275c_tan(Py_complex x)
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000276{
Guido van Rossum9e720e31996-07-21 02:31:35 +0000277 Py_complex r;
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000278 double sr,cr,shi,chi;
279 double rs,is,rc,ic;
280 double d;
281 sr = sin(x.real);
282 cr = cos(x.real);
283 shi = sinh(x.imag);
284 chi = cosh(x.imag);
Tim Peters14e26402001-02-20 20:15:19 +0000285 rs = sr * chi;
286 is = cr * shi;
287 rc = cr * chi;
288 ic = -sr * shi;
289 d = rc*rc + ic * ic;
290 r.real = (rs*rc + is*ic) / d;
291 r.imag = (is*rc - rs*ic) / d;
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000292 return r;
293}
294
Tim Peters14e26402001-02-20 20:15:19 +0000295static char c_tan_doc[] =
296"tan(x)\n"
297"\n"
298"Return the tangent of x.";
Guido van Rossumc6e22901998-12-04 19:26:43 +0000299
300
Tim Peters14e26402001-02-20 20:15:19 +0000301static Py_complex
302c_tanh(Py_complex x)
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000303{
Guido van Rossum9e720e31996-07-21 02:31:35 +0000304 Py_complex r;
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000305 double si,ci,shr,chr;
306 double rs,is,rc,ic;
307 double d;
308 si = sin(x.imag);
309 ci = cos(x.imag);
310 shr = sinh(x.real);
311 chr = cosh(x.real);
Tim Peters14e26402001-02-20 20:15:19 +0000312 rs = ci * shr;
313 is = si * chr;
314 rc = ci * chr;
315 ic = si * shr;
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000316 d = rc*rc + ic*ic;
Tim Peters14e26402001-02-20 20:15:19 +0000317 r.real = (rs*rc + is*ic) / d;
318 r.imag = (is*rc - rs*ic) / d;
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000319 return r;
320}
321
Tim Peters14e26402001-02-20 20:15:19 +0000322static char c_tanh_doc[] =
323"tanh(x)\n"
324"\n"
325"Return the hyperbolic tangent of x.";
Guido van Rossumc6e22901998-12-04 19:26:43 +0000326
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000327
328/* And now the glue to make them available from Python: */
329
Roger E. Masse24070ca1996-12-09 22:59:53 +0000330static PyObject *
Thomas Woutersf3f33dc2000-07-21 06:00:07 +0000331math_error(void)
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000332{
333 if (errno == EDOM)
Roger E. Masse24070ca1996-12-09 22:59:53 +0000334 PyErr_SetString(PyExc_ValueError, "math domain error");
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000335 else if (errno == ERANGE)
Roger E. Masse24070ca1996-12-09 22:59:53 +0000336 PyErr_SetString(PyExc_OverflowError, "math range error");
337 else /* Unexpected math error */
Tim Peters14e26402001-02-20 20:15:19 +0000338 PyErr_SetFromErrno(PyExc_ValueError);
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000339 return NULL;
340}
341
Roger E. Masse24070ca1996-12-09 22:59:53 +0000342static PyObject *
Peter Schneider-Kampf1ca8982000-07-10 09:31:34 +0000343math_1(PyObject *args, Py_complex (*func)(Py_complex))
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000344{
Guido van Rossum9e720e31996-07-21 02:31:35 +0000345 Py_complex x;
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000346 if (!PyArg_ParseTuple(args, "D", &x))
347 return NULL;
348 errno = 0;
Guido van Rossum52fa3a61997-02-14 22:59:58 +0000349 PyFPE_START_PROTECT("complex function", return 0)
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000350 x = (*func)(x);
Guido van Rossum45b83911997-03-14 04:32:50 +0000351 PyFPE_END_PROTECT(x)
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000352 CHECK(x.real);
353 CHECK(x.imag);
354 if (errno != 0)
355 return math_error();
356 else
Roger E. Masse24070ca1996-12-09 22:59:53 +0000357 return PyComplex_FromCComplex(x);
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000358}
359
360#define FUNC1(stubname, func) \
Peter Schneider-Kampf1ca8982000-07-10 09:31:34 +0000361 static PyObject * stubname(PyObject *self, PyObject *args) { \
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000362 return math_1(args, func); \
363 }
364
365FUNC1(cmath_acos, c_acos)
366FUNC1(cmath_acosh, c_acosh)
367FUNC1(cmath_asin, c_asin)
368FUNC1(cmath_asinh, c_asinh)
369FUNC1(cmath_atan, c_atan)
370FUNC1(cmath_atanh, c_atanh)
371FUNC1(cmath_cos, c_cos)
372FUNC1(cmath_cosh, c_cosh)
373FUNC1(cmath_exp, c_exp)
374FUNC1(cmath_log, c_log)
375FUNC1(cmath_log10, c_log10)
376FUNC1(cmath_sin, c_sin)
377FUNC1(cmath_sinh, c_sinh)
378FUNC1(cmath_sqrt, c_sqrt)
379FUNC1(cmath_tan, c_tan)
380FUNC1(cmath_tanh, c_tanh)
381
382
Tim Peters14e26402001-02-20 20:15:19 +0000383static char module_doc[] =
384"This module is always available. It provides access to mathematical\n"
385"functions for complex numbers.";
Guido van Rossumc6e22901998-12-04 19:26:43 +0000386
Roger E. Masse24070ca1996-12-09 22:59:53 +0000387static PyMethodDef cmath_methods[] = {
Tim Peters14e26402001-02-20 20:15:19 +0000388 {"acos", cmath_acos, METH_VARARGS, c_acos_doc},
389 {"acosh", cmath_acosh, METH_VARARGS, c_acosh_doc},
390 {"asin", cmath_asin, METH_VARARGS, c_asin_doc},
391 {"asinh", cmath_asinh, METH_VARARGS, c_asinh_doc},
392 {"atan", cmath_atan, METH_VARARGS, c_atan_doc},
393 {"atanh", cmath_atanh, METH_VARARGS, c_atanh_doc},
394 {"cos", cmath_cos, METH_VARARGS, c_cos_doc},
395 {"cosh", cmath_cosh, METH_VARARGS, c_cosh_doc},
396 {"exp", cmath_exp, METH_VARARGS, c_exp_doc},
397 {"log", cmath_log, METH_VARARGS, c_log_doc},
398 {"log10", cmath_log10, METH_VARARGS, c_log10_doc},
399 {"sin", cmath_sin, METH_VARARGS, c_sin_doc},
400 {"sinh", cmath_sinh, METH_VARARGS, c_sinh_doc},
401 {"sqrt", cmath_sqrt, METH_VARARGS, c_sqrt_doc},
402 {"tan", cmath_tan, METH_VARARGS, c_tan_doc},
403 {"tanh", cmath_tanh, METH_VARARGS, c_tanh_doc},
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000404 {NULL, NULL} /* sentinel */
405};
406
Guido van Rossum3886bb61998-12-04 18:50:17 +0000407DL_EXPORT(void)
Thomas Woutersf3f33dc2000-07-21 06:00:07 +0000408initcmath(void)
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000409{
Roger E. Masse24070ca1996-12-09 22:59:53 +0000410 PyObject *m, *d, *v;
Tim Peters14e26402001-02-20 20:15:19 +0000411
Guido van Rossumc6e22901998-12-04 19:26:43 +0000412 m = Py_InitModule3("cmath", cmath_methods, module_doc);
Roger E. Masse24070ca1996-12-09 22:59:53 +0000413 d = PyModule_GetDict(m);
414 PyDict_SetItemString(d, "pi",
415 v = PyFloat_FromDouble(atan(1.0) * 4.0));
416 Py_DECREF(v);
417 PyDict_SetItemString(d, "e", v = PyFloat_FromDouble(exp(1.0)));
418 Py_DECREF(v);
Guido van Rossum71aa32f1996-01-12 01:34:57 +0000419}