1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
open Ast
(*
--# Variance
--#
--# Compute sample variance.
--#
--# @name var
--# @param x :: Vector | List Numeric input.
--# @param na_rm :: Bool = false Remove NA values first.
--# @param weights :: Vector[Float] | List[Float] = NA Optional non-negative observation weights.
--# @return :: Number | Vector Computed result (scalar or vectorized).
--# @family stats
--# @export
*)
let has_na_rm named_args =
List.exists (fun (name, v) -> name = Some "na_rm" && match v with VBool true -> true | _ -> false) named_args
let strip_na_rm named_args =
List.filter (fun (name, _) -> name <> Some "na_rm") named_args |> List.map snd
let numeric_values ~label ~na_rm v =
let vals =
match v with
| VVector arr -> Ok (Array.to_list arr)
| VList items -> Ok (List.map snd items)
| VNA _ -> Error (Error.na_value_error ~na_rm:true label)
| _ -> Error (Error.type_error (Printf.sprintf "Function `%s` expects a numeric List or Vector." label))
in
match vals with
| Error e -> Error e
| Ok vals ->
let rec go acc = function
| [] -> Ok (List.rev acc)
| VInt n :: tl -> go (float_of_int n :: acc) tl
| VFloat f :: tl -> go (f :: acc) tl
| VNA _ :: tl when na_rm -> go acc tl
| VNA _ :: _ -> Error (Error.na_value_error ~na_rm:true label)
| _ -> Error (Error.type_error (Printf.sprintf "Function `%s` requires numeric values." label))
in
go [] vals
let mean xs =
let n = List.length xs in
if n = 0 then None else Some (List.fold_left ( +. ) 0.0 xs /. float_of_int n)
let register env =
Env.add "var" (make_builtin_named ~name:"var" ~variadic:true 1 (fun named_args _ ->
match Math_common.get_bool_flag "na_rm" false named_args with
| Error e -> e
| Ok na_rm ->
let args = Math_common.positional_args_without ["na_rm"; "weights"] named_args in
let weight_arg = Math_common.optional_named_arg "weights" named_args in
match args with
| [x] ->
(match weight_arg with
| Some weight_v ->
(match Math_utils.extract_numeric_array_with_weights ~label:"var" ~na_rm x weight_v with
| Error e -> e
| Ok (xs, ws) ->
if Array.length xs < 2 then Error.value_error "Function `var` requires at least 2 values."
else
(match Math_utils.weighted_variance_population xs ws with
| Some v -> VFloat v
| None -> Error.make_error RuntimeError "Function `var` internal error: weighted variance could not be computed."))
| None ->
(match numeric_values ~label:"var" ~na_rm x with
| Error e -> e
| Ok [] -> VNA NAFloat
| Ok xs ->
let n = List.length xs in
if n < 2 then Error.value_error "Function `var` requires at least 2 values."
else
match mean xs with
| None -> Error.make_error RuntimeError "Function `var` internal error: mean returned None for non-empty list."
| Some m ->
let ss = List.fold_left (fun a v -> let d = v -. m in a +. d *. d) 0.0 xs in
VFloat (ss /. float_of_int (n - 1))))
| args -> Error.arity_error_named "var" 1 (List.length args))) env