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 */
17dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond
18dee0849a9704d532af0b550146cbafbaa6ee1d19Raymondpackage org.apache.commons.math.distribution;
19dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond
20dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond/**
21dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * Normal (Gauss) Distribution.
22dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond *
23dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * <p>
24dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * References:</p><p>
25dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * <ul>
26dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * <li><a href="http://mathworld.wolfram.com/NormalDistribution.html">
27dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * Normal Distribution</a></li>
28dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * </ul>
29dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * </p>
30dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond *
31dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond * @version $Revision: 920852 $ $Date: 2010-03-09 13:53:44 +0100 (mar. 09 mars 2010) $
32dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond */
33dee0849a9704d532af0b550146cbafbaa6ee1d19Raymondpublic interface NormalDistribution extends ContinuousDistribution, HasDensity<Double> {
34dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond    /**
35dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond     * Access the mean.
36dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond     * @return mean for this distribution
37dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond     */
38dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond    double getMean();
39dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond    /**
40dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond     * Modify the mean.
41dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond     * @param mean for this distribution
42dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond     * @deprecated as of v2.1
43dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond     */
44dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond    @Deprecated
45dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond    void setMean(double mean);
46dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond    /**
47dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond     * Access the standard deviation.
48dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond     * @return standard deviation for this distribution
49dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond     */
50dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond    double getStandardDeviation();
51dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond    /**
52dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond     * Modify the standard deviation.
53dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond     * @param sd standard deviation for this distribution
54dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond     * @deprecated as of v2.1
55dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond     */
56dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond    @Deprecated
57dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond    void setStandardDeviation(double sd);
58dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond
59dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond    /**
60dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond     * Return the probability density for a particular point.
61dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond     * @param x  The point at which the density should be computed.
62dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond     * @return  The pdf at point x.
63dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond     */
64dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond    double density(Double x);
65dee0849a9704d532af0b550146cbafbaa6ee1d19Raymond}
66