ChangeBasis changes the projection basis (unit vectors) of a given vector function to the projection basis indicated newbasis. Optionally, when the argument alsocomponents is given, the components of the vector are also rewritten in terms of the natural coordinates related to newbasis. ChangeBasis is thus complementary to ChangeCoordinates. For the conventions used in the Physics[Vectors] subpackage to represent vector functions, see conventions.

The %ChangeBasis is the inert form of ChangeBasis, that is: it represents the same mathematical operation while holding the operation unperformed. To activate the operation use value.

If $A$ is not a vector function, then an error message is returned.

If $A$ is a non-projected vector, then ChangeBasis returns unevaluated.

Otherwise, the projection basis is changed according to:

From cartesian basis to cylindrical basis:

From cartesian basis to spherical basis:

From cylindrical basis to spherical basis:

When changing the basis, some extra factors depending on the coordinates are introduced. These factors are always expressed in the "upper" coordinate's system; i.e., the transformation from cartesian to cylindrical (from 1 to 2) will introduce factors depending on $\mathrm{\phi }$, and so on, as shown in the examples below.

Note that, by default, only the projection basis is changed, not the coefficients of the unit vectors (components). To additionally change the components of the vector, re-expressing them in terms of the natural coordinates of the indicated newbasis, use the optional argument alsocomponents.

$\mathrm{with}\left(\mathrm{Physics}\left[\mathrm{Vectors}\right]\right)$

$\left[\mathrm{\&x}\,\mathrm{`+`}\,\mathrm{`.`}\,\mathrm{Assume}\,\mathrm{ChangeBasis}\,\mathrm{ChangeCoordinates}\,\mathrm{CompactDisplay}\,\mathrm{Component}\,\mathrm{Curl}\,\mathrm{DirectionalDiff}\,\mathrm{Divergence}\,\mathrm{Gradient}\,\mathrm{Identify}\,\mathrm{Laplacian}\,\nabla \,\mathrm{Norm}\,\mathrm{ParametrizeCurve}\,\mathrm{ParametrizeSurface}\,\mathrm{ParametrizeVolume}\,\mathrm{Setup}\,\mathrm{Simplify}\,\mathrm{`^`}\,\mathrm{diff}\,\mathrm{int}\right]$

$\mathrm{Setup}\left(\mathrm{mathematicalnotation}=\mathrm{true}\right)$

$\left[\mathrm{mathematicalnotation}=\mathrm{true}\right]$

$R≔x\mathrm{\_i}+y\mathrm{\_j}+z\mathrm{\_k}$

$R≔x\stackrel{\wedge }{i}+y\stackrel{\wedge }{j}+z\stackrel{\wedge }{k}$

$\mathrm{ChangeBasis}\left(R\,1\right)$

$x\stackrel{\wedge }{i}+y\stackrel{\wedge }{j}+z\stackrel{\wedge }{k}$

$\mathrm{ChangeBasis}\left(R\,2\right)$

$\left(x\cos \left(\mathrm{\phi }\right)+y\sin \left(\mathrm{\phi }\right)\right)\stackrel{\wedge }{\mathrm{\rho }}+\left(\cos \left(\mathrm{\phi }\right)y-\sin \left(\mathrm{\phi }\right)x\right)\stackrel{\wedge }{\mathrm{\phi }}+z\stackrel{\wedge }{k}$

$\mathrm{ChangeBasis}\left(R\,\mathrm{cylindrical}\,\mathrm{alsocomponents}\right)$

$z\stackrel{\wedge }{k}+\mathrm{\rho }\stackrel{\wedge }{\mathrm{\rho }}$

$\mathrm{ChangeBasis}\left(R\,s\right)$

$\mathrm{*\; Partial\; match\; of\; \text{'}}s\mathrm{\text{'}\; against\; keyword\; \text{'}}\mathrm{spherical}\text{'}$

$\left(x\sin \left(\mathrm{\theta }\right)\cos \left(\mathrm{\phi }\right)+y\sin \left(\mathrm{\theta }\right)\sin \left(\mathrm{\phi }\right)+z\cos \left(\mathrm{\theta }\right)\right)\stackrel{\wedge }{r}+\left(x\cos \left(\mathrm{\phi }\right)\cos \left(\mathrm{\theta }\right)+y\sin \left(\mathrm{\phi }\right)\cos \left(\mathrm{\theta }\right)-z\sin \left(\mathrm{\theta }\right)\right)\stackrel{\wedge }{\mathrm{\theta }}+\left(\cos \left(\mathrm{\phi }\right)y-\sin \left(\mathrm{\phi }\right)x\right)\stackrel{\wedge }{\mathrm{\phi }}$

$\mathrm{ChangeBasis}\left(R\,\mathrm{spherical}\,\mathrm{alsocomponents}\right)$

$r\stackrel{\wedge }{r}$