Important: The stats package has been deprecated. Use the superseding package Statistics instead.

The function apply of the subpackage stats[transform, ...] applies the requested function to the given data.

It is much easier to analyze the relationship between two sets of data when the relationship is linear. It may very well be, though, that the relationship is not linear. For example, one set of data could be made of points that are the square of the corresponding points in the other set of data. In that case, a linear relation is obtained between the square root of the first set and the original second set. The map() function can be useful in that regard, but it does not behave correctly with respect to weighted data, classes and missing data. The apply() function handles correctly the various stats data types.

Another common use of data transformation is to make the distribution more symmetric. This makes it easier to do the comparison with theoretical distributions such as the normal distribution. Transformations such as raising to a power greater than one increases the skewness to the right (in other words spreads the data towards the right), whereas a power lower than one increases the skewness to the left (the data is spread towards the left). Refer to describe[skewness] for more information on the skewness.

The requested function is applied at each boundary points of classes. To ensure correct subsequent results, the requested function must preserve the order of the boundary points. For example, the transformation $x\mapsto \frac{1}{x}$ does not preserve the order; therefore, the transformation $x\mapsto -\frac{1}{x}$ is preferred.

The functions transform[divideby] and transform[remove] are specialized versions of transform[apply]. They might be more appropriate to your particular requirements.

Missing items remain unchanged.

$\mathrm{with}\left(\mathrm{stats}\right)\:$

$\mathrm{data1}≔\left[1\,4\,9\,16\,25\right]$

$\mathrm{data1}≔\left[1\,4\,9\,16\,25\right]$

$\mathrm{transform}\left[\mathrm{apply}\left[x\mapsto \mathrm{sqrt}\left(x\right)\right]\right]\left(\mathrm{data1}\right)$

$\left[1\,2\,3\,4\,5\right]$

$\mathrm{data2}≔\left[1\,\mathrm{sqrt}\left(2\right)\,\mathrm{sqrt}\left(3\right)\,2\right]\:$$\mathrm{evalf}\left(\right)$

$\left[1.\,2.\,3.\,4.\,5.\right]$

$\mathrm{transform}\left[\mathrm{apply}\left[x\mapsto x^2\right]\right]\left(\mathrm{data2}\right)$

$\left[1\,2\,3\,4\right]$

$\mathrm{data3}≔\left[\mathrm{Weight}\left(3\,10\right)\,\mathrm{missing}\,4\,\mathrm{Weight}\left(11..12\,3\right)\right]$

$\mathrm{data3}≔\left[\mathrm{Weight}\left(3\,10\right)\,\mathrm{missing}\,4\,\mathrm{Weight}\left(11..12\,3\right)\right]$

$\mathrm{transform}\left[\mathrm{apply}\left[x\mapsto -\frac{1}{x}\right]\right]\left(\mathrm{data3}\right)$

$\left[\mathrm{Weight}\left(-\frac{1}{3}\,10\right)\,\mathrm{missing}\,-\frac{1}{4}\,\mathrm{Weight}\left(-\frac{1}{11}..-\frac{1}{12}\,3\right)\right]$

$\mathrm{data4}≔\left[0\,1\,3\,7\right]$

$\mathrm{data4}≔\left[0\,1\,3\,7\right]$

$\mathrm{data5}≔\left[1\,8\,64\,512\right]$

$\mathrm{data5}≔\left[1\,8\,64\,512\right]$

$\mathrm{transform}\left[\mathrm{apply}\left[x\mapsto x+1\right]\right]\left(\mathrm{data4}\right)$

$\left[1\,2\,4\,8\right]$

$\mathrm{transform}\left[\mathrm{apply}\left[x\mapsto \mathrm{simplify}\left(x^{\raisebox{1ex}{$1$}\!\left/ \!\raisebox{-1ex}{$3$}\right.}\right)\right]\right]\left(\mathrm{data5}\right)$

$\left[1\,2\,4\,8\right]$