Logistic                package:stats                R Documentation

_T_h_e _L_o_g_i_s_t_i_c _D_i_s_t_r_i_b_u_t_i_o_n

_D_e_s_c_r_i_p_t_i_o_n:

     Density, distribution function, quantile function and random
     generation for the logistic distribution with parameters
     'location' and 'scale'.

_U_s_a_g_e:

     dlogis(x, location = 0, scale = 1, log = FALSE)
     plogis(q, location = 0, scale = 1, lower.tail = TRUE, log.p = FALSE)
     qlogis(p, location = 0, scale = 1, lower.tail = TRUE, log.p = FALSE)
     rlogis(n, location = 0, scale = 1)

_A_r_g_u_m_e_n_t_s:

    x, q: vector of quantiles.

       p: vector of probabilities.

       n: number of observations. If 'length(n) > 1', the length is
          taken to be the number required.

location, scale: location and scale parameters.

log, log.p: logical; if TRUE, probabilities p are given as log(p).

lower.tail: logical; if TRUE (default), probabilities are P[X <= x],
          otherwise, P[X > x].

_D_e_t_a_i_l_s:

     If 'location' or 'scale' are omitted, they assume the default
     values of '0' and '1' respectively.

     The Logistic distribution with 'location' = m and 'scale' = s has
     distribution function

                    F(x) = 1 / (1 + exp(-(x-m)/s))

     and density

            f(x) = 1/s exp((x-m)/s) (1 + exp((x-m)/s))^-2.


     It is a long-tailed distribution with mean m and variance pi^2 /3
     s^2.

_V_a_l_u_e:

     'dlogis' gives the density, 'plogis' gives the distribution
     function, 'qlogis' gives the quantile function, and 'rlogis'
     generates random deviates.

_N_o_t_e:

     'qlogis(p)' is the same as the well known '_logit_' function,
     logit(p) = log(p/(1-p)), and 'plogis(x)' has consequently been
     called the 'inverse logit'.

     The distribution function is a rescaled hyperbolic tangent,
     'plogis(x) == (1+ tanh(x/2))/2', and it is called a _sigmoid
     function_ in contexts such as neural networks.

_S_o_u_r_c_e:

     '[dpr]logis' are calculated directly from the definitions.

     'rlogis' uses inversion.

_R_e_f_e_r_e_n_c_e_s:

     Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988) _The New S
     Language_. Wadsworth & Brooks/Cole.

     Johnson, N. L., Kotz, S. and Balakrishnan, N. (1995) _Continuous
     Univariate Distributions_, volume 2, chapter 23. Wiley, New York.

_E_x_a_m_p_l_e_s:

     var(rlogis(4000, 0, scale = 5))# approximately (+/- 3)
     pi^2/3 * 5^2

