Difference between revisions of "Tc"
(→Implementation) |
|||
Line 63: | Line 63: | ||
== Implementation == | == Implementation == | ||
− | + | The code below is a possible implementation. | |
+ | Only the functions I most use are implemented (not cosh, not ==, etc... for instance). | ||
+ | It not optimized and there is no specific handling of division by 0 and overflow, which I imagine may be problematic. | ||
+ | |||
+ | <syntaxhighlight> | ||
+ | #include <complex> | ||
+ | |||
+ | typedef double real; | ||
+ | typedef complex<real> cplx; | ||
+ | |||
+ | class tc { | ||
+ | public : // all the members below are accessible by users of the package | ||
+ | // data members | ||
+ | cplx z; | ||
+ | cplx dz; | ||
+ | // member functions (declarations only, the code is given below*) | ||
+ | // *: for this C++ unses the following (ugly) syntax | ||
+ | // return-type class-name::function-name(parameters) { code; } | ||
+ | // constructors | ||
+ | tc(cplx=cplx(0,0), cplx=cplx(0,0)); // default constructor | ||
+ | tc(const tc&); // copy constructor | ||
+ | // assigment operations : unlike math operations and math functions, they /have/ to belong to the class | ||
+ | tc& operator=(const tc&); | ||
+ | const real& operator=(const real&); | ||
+ | const cplx& operator=(const cplx&); | ||
+ | }; | ||
+ | |||
+ | // now we give the code of the member functions | ||
+ | |||
+ | // a constructor | ||
+ | tc::tc(cplx point, cplx vecteur) | ||
+ | { | ||
+ | z = point; | ||
+ | dz = vecteur; | ||
+ | } | ||
+ | |||
+ | // the copy constructor | ||
+ | tc::tc(const tc& t) | ||
+ | { | ||
+ | z = t.z; | ||
+ | dz = t.dz; | ||
+ | } | ||
+ | |||
+ | // assignment operators | ||
+ | |||
+ | tc& tc::operator=(const tc& t) | ||
+ | { | ||
+ | z = t.z; | ||
+ | dz = t.dz; | ||
+ | return *this; | ||
+ | } | ||
+ | |||
+ | const real& tc::operator=(const real& r) | ||
+ | { | ||
+ | z = r; | ||
+ | dz = 0; | ||
+ | return r; | ||
+ | } | ||
+ | |||
+ | const cplx& tc::operator=(const cplx& c) | ||
+ | { | ||
+ | z = c; | ||
+ | dz = 0; | ||
+ | return c; | ||
+ | } | ||
+ | |||
+ | // non-member functions : usual math operators and math functions | ||
+ | |||
+ | tc operator*(const tc& a, const tc& b) { | ||
+ | return tc(a.z*b.z, a.z*b.dz+a.dz*b.z); | ||
+ | } | ||
+ | |||
+ | tc operator*(const real& a, const tc& b) { | ||
+ | return tc(a*b.z, a*b.dz); | ||
+ | } | ||
+ | |||
+ | tc operator*(const tc& a, const real& b) { | ||
+ | return tc(a.z*b, a.dz*b); | ||
+ | } | ||
+ | |||
+ | tc operator+(const tc& a, const tc& b) { | ||
+ | return tc(a.z+b.z,a.dz+b.dz); | ||
+ | } | ||
+ | |||
+ | tc operator+(const real& a, const tc& b) { | ||
+ | return tc(a+b.z,b.dz); | ||
+ | } | ||
+ | |||
+ | tc operator+(const tc& a, const real& b) { | ||
+ | return tc(a.z+b,a.dz); | ||
+ | } | ||
+ | |||
+ | tc operator-(const tc& a) { | ||
+ | return tc(-a.z,-a.dz); | ||
+ | } | ||
+ | |||
+ | tc operator-(const tc& a, const tc& b) { | ||
+ | return tc(a.z-b.z,a.dz-b.dz); | ||
+ | } | ||
+ | |||
+ | tc operator-(const real& a, const tc& b) { | ||
+ | return tc(a-b.z,-b.dz); | ||
+ | } | ||
+ | |||
+ | tc operator-(const tc& a, const real& b) { | ||
+ | return tc(a.z-b,a.dz); | ||
+ | } | ||
+ | |||
+ | tc operator/(const tc& a, const tc& b) { | ||
+ | return tc(a.z/b.z,a.dz/b.z-a.z*b.dz/(b.z*b.z)); | ||
+ | } | ||
+ | |||
+ | tc operator/(const real& a, const tc& b) { | ||
+ | return tc(a/b.z,-a*b.dz/(b.z*b.z)); | ||
+ | } | ||
+ | |||
+ | tc operator/(const tc& a, const real& b) { | ||
+ | return tc(a.z/b,a.dz/b); | ||
+ | } | ||
+ | |||
+ | tc exp(const tc& a) { | ||
+ | cplx aux=exp(a.z); | ||
+ | return tc(aux,aux*a.dz); | ||
+ | } | ||
+ | |||
+ | tc sin(const tc& a) { | ||
+ | return((exp(a*tc(0,1))-exp(a*tc(0,-1)))*tc(0,-0.5)); | ||
+ | } | ||
+ | |||
+ | tc cos(const tc& a) { | ||
+ | return((exp(a*tc(0,1))+exp(a*tc(0,-1)))*0.5); | ||
+ | } | ||
+ | |||
+ | tc tan(const tc& a) { | ||
+ | return(sin(a)/cos(a)); | ||
+ | } | ||
+ | |||
+ | tc log(const tc& a) { | ||
+ | return tc(log(a.z),a.dz/a.z); | ||
+ | } | ||
+ | |||
+ | tc sqrt(const tc& a) { | ||
+ | return exp(0.5*log(a)); | ||
+ | } | ||
+ | |||
+ | tc conj(const tc& a) { // CAUTION : here when interpreting the dz part, only real values of 'time' make sense | ||
+ | return tc(conj(a.z), conj(a.dz)); | ||
+ | } | ||
+ | |||
+ | static const complex I(0,1); | ||
+ | </syntaxhighlight> |
Revision as of 22:37, 18 December 2015
A tc is a data structure encoding a complex number and a variation of this number. The operations I define on these numbers are the same as most operations on complex numbers. The corresponding C++ library of functions that I designed really made writing my programs easier, especially for distance estimator methods.
Contents
Overview
A tc is a complex number z together with a complex vector dz attached. The notation dz is probably not the best but it is to mimic physicist notation, like \[(z+dz)\times(w+dw)=w\,z+(w\,dz+z\,dw)+\text{neglected}\] or \[\cos(z+dz)=\cos(z)-\sin(z)dz.\] A mathematical reinterpretation in terms of jets is given below.
Operator overloading
C++ allows operator overloading. In other words, you can use instructions like d=c+a*b in your programs, with any kind type of objects for a,b,c,d.
This is why it is much easier to program with complex numbers in C++ than in many other languages. Compare C++
z=u*z*(z*z+cos(c*z)+d);
with Java (no operator overloading)
z=mul(u,mul(z,add(mul(z,z),add(cos(mul(c,z)),d))));
or worse, with C
mul(w,c,z);
cos(w,w);
add(w,w,d);
mul(v,z,z);
add(w,w,v);
mul(w,z,w);
mul(z,u,w);
Operations
One defines operations on tc objects as follows: \[(z,dz) + (w,dw) = (z+w,dz+dw)\] \[(z,dz) \times (w,dw) = (z\,w,w\,dz+z\,dw)\] \[-(z,dz) = (-z,-dz)\] \[1/(z,dz) = (1/z,-dz/zˆ2)\] \[\overline{(z,dz)} = (\overline{z},\overline{dz})\] \[\exp(z,dz)=(\exp(z),\exp(z)dz)\] \[\cos(z,dz)=(\cos(z),-\sin(z)dz)\] \[etc...\]
Tangent space and jets
One can imagine that a tc pair (z,dz) represents a moving point, starting from z and moving at speed dz: $z(t)=z+dz\,t+o(t)$ . In other words it is an element in the tangent space TC of the complex numbers field C. This is why I chose the name tc for the C++ class. It can also be considered as 1-jets (can be generalized to higher degree power series expansions, like the $(z,b,c)$ being a 2-jet representing $z(t)=z+b\,t+c\,t^2+o(t^2)$). Jets are differential geometry object, i.e. there are specific formulae for computing how their expression (coordinates) changes when changing variables.
Derivatives
The tc objects compute derivatives for you!
Say you defined Z=(z,1), computed W=cos(Z×Z) and got W=(a,b). Then a=cos(z×z) and b=the derivative ∂a/∂z at z: you did not need to determine that $\partial \cos(z^2)/\partial z=-2z\sin(z^2)$, the class computed b iteratively for you.
Implementation
The code below is a possible implementation. Only the functions I most use are implemented (not cosh, not ==, etc... for instance). It not optimized and there is no specific handling of division by 0 and overflow, which I imagine may be problematic.
#include <complex>
typedef double real;
typedef complex<real> cplx;
class tc {
public : // all the members below are accessible by users of the package
// data members
cplx z;
cplx dz;
// member functions (declarations only, the code is given below*)
// *: for this C++ unses the following (ugly) syntax
// return-type class-name::function-name(parameters) { code; }
// constructors
tc(cplx=cplx(0,0), cplx=cplx(0,0)); // default constructor
tc(const tc&); // copy constructor
// assigment operations : unlike math operations and math functions, they /have/ to belong to the class
tc& operator=(const tc&);
const real& operator=(const real&);
const cplx& operator=(const cplx&);
};
// now we give the code of the member functions
// a constructor
tc::tc(cplx point, cplx vecteur)
{
z = point;
dz = vecteur;
}
// the copy constructor
tc::tc(const tc& t)
{
z = t.z;
dz = t.dz;
}
// assignment operators
tc& tc::operator=(const tc& t)
{
z = t.z;
dz = t.dz;
return *this;
}
const real& tc::operator=(const real& r)
{
z = r;
dz = 0;
return r;
}
const cplx& tc::operator=(const cplx& c)
{
z = c;
dz = 0;
return c;
}
// non-member functions : usual math operators and math functions
tc operator*(const tc& a, const tc& b) {
return tc(a.z*b.z, a.z*b.dz+a.dz*b.z);
}
tc operator*(const real& a, const tc& b) {
return tc(a*b.z, a*b.dz);
}
tc operator*(const tc& a, const real& b) {
return tc(a.z*b, a.dz*b);
}
tc operator+(const tc& a, const tc& b) {
return tc(a.z+b.z,a.dz+b.dz);
}
tc operator+(const real& a, const tc& b) {
return tc(a+b.z,b.dz);
}
tc operator+(const tc& a, const real& b) {
return tc(a.z+b,a.dz);
}
tc operator-(const tc& a) {
return tc(-a.z,-a.dz);
}
tc operator-(const tc& a, const tc& b) {
return tc(a.z-b.z,a.dz-b.dz);
}
tc operator-(const real& a, const tc& b) {
return tc(a-b.z,-b.dz);
}
tc operator-(const tc& a, const real& b) {
return tc(a.z-b,a.dz);
}
tc operator/(const tc& a, const tc& b) {
return tc(a.z/b.z,a.dz/b.z-a.z*b.dz/(b.z*b.z));
}
tc operator/(const real& a, const tc& b) {
return tc(a/b.z,-a*b.dz/(b.z*b.z));
}
tc operator/(const tc& a, const real& b) {
return tc(a.z/b,a.dz/b);
}
tc exp(const tc& a) {
cplx aux=exp(a.z);
return tc(aux,aux*a.dz);
}
tc sin(const tc& a) {
return((exp(a*tc(0,1))-exp(a*tc(0,-1)))*tc(0,-0.5));
}
tc cos(const tc& a) {
return((exp(a*tc(0,1))+exp(a*tc(0,-1)))*0.5);
}
tc tan(const tc& a) {
return(sin(a)/cos(a));
}
tc log(const tc& a) {
return tc(log(a.z),a.dz/a.z);
}
tc sqrt(const tc& a) {
return exp(0.5*log(a));
}
tc conj(const tc& a) { // CAUTION : here when interpreting the dz part, only real values of 'time' make sense
return tc(conj(a.z), conj(a.dz));
}
static const complex I(0,1);