1dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond/* 2dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * Licensed to the Apache Software Foundation (ASF) under one or more 3dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * contributor license agreements. See the NOTICE file distributed with 4dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * this work for additional information regarding copyright ownership. 5dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * The ASF licenses this file to You under the Apache License, Version 2.0 6dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * (the "License"); you may not use this file except in compliance with 7dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * the License. You may obtain a copy of the License at 8dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * 9dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * http://www.apache.org/licenses/LICENSE-2.0 10dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * 11dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * Unless required by applicable law or agreed to in writing, software 12dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * distributed under the License is distributed on an "AS IS" BASIS, 13dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * See the License for the specific language governing permissions and 15dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * limitations under the License. 16dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond */ 17dee0849a9704d532af0b550146cbafbaa6ee1d19Raymondpackage org.apache.commons.math.stat.descriptive; 18dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond 19dee0849a9704d532af0b550146cbafbaa6ee1d19Raymondimport org.apache.commons.math.linear.RealMatrix; 20dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond 21dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond/** 22dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * Reporting interface for basic multivariate statistics. 23dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * 24dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * @since 1.2 25dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * @version $Revision: 811786 $ $Date: 2009-09-06 11:36:08 +0200 (dim. 06 sept. 2009) $ 26dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond */ 27dee0849a9704d532af0b550146cbafbaa6ee1d19Raymondpublic interface StatisticalMultivariateSummary { 28dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond 29dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond /** 30dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * Returns the dimension of the data 31dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * @return The dimension of the data 32dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond */ 33dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond int getDimension(); 34dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond 35dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond /** 36dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * Returns an array whose i<sup>th</sup> entry is the 37dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * mean of the i<sup>th</sup> entries of the arrays 38dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * that correspond to each multivariate sample 39dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * 40dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * @return the array of component means 41dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond */ 42dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond double[] getMean(); 43dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond 44dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond /** 45dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * Returns the covariance of the available values. 46dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * @return The covariance, null if no multivariate sample 47dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * have been added or a zeroed matrix for a single value set. 48dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond */ 49dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond RealMatrix getCovariance(); 50dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond 51dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond /** 52dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * Returns an array whose i<sup>th</sup> entry is the 53dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * standard deviation of the i<sup>th</sup> entries of the arrays 54dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * that correspond to each multivariate sample 55dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * 56dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * @return the array of component standard deviations 57dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond */ 58dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond double[] getStandardDeviation(); 59dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond 60dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond /** 61dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * Returns an array whose i<sup>th</sup> entry is the 62dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * maximum of the i<sup>th</sup> entries of the arrays 63dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * that correspond to each multivariate sample 64dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * 65dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * @return the array of component maxima 66dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond */ 67dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond double[] getMax(); 68dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond 69dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond /** 70dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * Returns an array whose i<sup>th</sup> entry is the 71dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * minimum of the i<sup>th</sup> entries of the arrays 72dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * that correspond to each multivariate sample 73dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * 74dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * @return the array of component minima 75dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond */ 76dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond double[] getMin(); 77dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond 78dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond /** 79dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * Returns the number of available values 80dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * @return The number of available values 81dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond */ 82dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond long getN(); 83dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond 84dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond /** 85dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * Returns an array whose i<sup>th</sup> entry is the 86dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * geometric mean of the i<sup>th</sup> entries of the arrays 87dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * that correspond to each multivariate sample 88dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * 89dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * @return the array of component geometric means 90dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond */ 91dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond double[] getGeometricMean(); 92dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond 93dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond /** 94dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * Returns an array whose i<sup>th</sup> entry is the 95dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * sum of the i<sup>th</sup> entries of the arrays 96dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * that correspond to each multivariate sample 97dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * 98dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * @return the array of component sums 99dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond */ 100dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond double[] getSum(); 101dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond 102dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond /** 103dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * Returns an array whose i<sup>th</sup> entry is the 104dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * sum of squares of the i<sup>th</sup> entries of the arrays 105dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * that correspond to each multivariate sample 106dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * 107dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * @return the array of component sums of squares 108dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond */ 109dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond double[] getSumSq(); 110dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond 111dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond /** 112dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * Returns an array whose i<sup>th</sup> entry is the 113dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * sum of logs of the i<sup>th</sup> entries of the arrays 114dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * that correspond to each multivariate sample 115dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * 116dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * @return the array of component log sums 117dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond */ 118dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond double[] getSumLog(); 119dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond 120dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond} 121