Merge pull request #1119 from Kotlin/std

Overhaul for std

Author: Jolanrensen

core/api/core.api

@@ -1926,8 +1926,8 @@ public abstract interface class org/jetbrains/kotlinx/dataframe/api/DataSchemaEn
 }
 
 public final class org/jetbrains/kotlinx/dataframe/api/DefaultsKt {
-	public static final fun getDdof_default ()I
-	public static final fun getSkipNaN_default ()Z
+	public static final fun getDdofDefault ()I
+	public static final fun getSkipNaNDefault ()Z
 }
 
 public final class org/jetbrains/kotlinx/dataframe/api/DescribeKt {
@@ -4162,11 +4162,13 @@ public final class org/jetbrains/kotlinx/dataframe/api/SumKt {
 	public static synthetic fun sumFor$default (Lorg/jetbrains/kotlinx/dataframe/api/PivotGroupBy;[Lorg/jetbrains/kotlinx/dataframe/columns/ColumnReference;ZZILjava/lang/Object;)Lorg/jetbrains/kotlinx/dataframe/DataFrame;
 	public static final synthetic fun sumNumber (Lorg/jetbrains/kotlinx/dataframe/DataColumn;)Ljava/lang/Number;
 	public static final fun sumNumber (Lorg/jetbrains/kotlinx/dataframe/DataColumn;Z)Ljava/lang/Number;
+	public static final fun sumNumber (Lorg/jetbrains/kotlinx/dataframe/DataFrame;ZLkotlin/jvm/functions/Function2;)Ljava/lang/Number;
+	public static final fun sumNumber (Lorg/jetbrains/kotlinx/dataframe/DataFrame;Z[Lkotlin/reflect/KProperty;)Ljava/lang/Number;
+	public static final fun sumNumber (Lorg/jetbrains/kotlinx/dataframe/DataFrame;[Lorg/jetbrains/kotlinx/dataframe/columns/ColumnReference;Z)Ljava/lang/Number;
 	public static synthetic fun sumNumber$default (Lorg/jetbrains/kotlinx/dataframe/DataColumn;ZILjava/lang/Object;)Ljava/lang/Number;
-	public static final fun sumOfByte (Lorg/jetbrains/kotlinx/dataframe/DataColumn;Lkotlin/jvm/functions/Function1;)I
-	public static final fun sumOfByte (Lorg/jetbrains/kotlinx/dataframe/DataFrame;Lkotlin/jvm/functions/Function2;)I
-	public static final fun sumOfShort (Lorg/jetbrains/kotlinx/dataframe/DataColumn;Lkotlin/jvm/functions/Function1;)I
-	public static final fun sumOfShort (Lorg/jetbrains/kotlinx/dataframe/DataFrame;Lkotlin/jvm/functions/Function2;)I
+	public static synthetic fun sumNumber$default (Lorg/jetbrains/kotlinx/dataframe/DataFrame;ZLkotlin/jvm/functions/Function2;ILjava/lang/Object;)Ljava/lang/Number;
+	public static synthetic fun sumNumber$default (Lorg/jetbrains/kotlinx/dataframe/DataFrame;Z[Lkotlin/reflect/KProperty;ILjava/lang/Object;)Ljava/lang/Number;
+	public static synthetic fun sumNumber$default (Lorg/jetbrains/kotlinx/dataframe/DataFrame;[Lorg/jetbrains/kotlinx/dataframe/columns/ColumnReference;ZILjava/lang/Object;)Ljava/lang/Number;
 	public static final fun sumShort (Lorg/jetbrains/kotlinx/dataframe/DataColumn;)I
 	public static final fun sumShort (Lorg/jetbrains/kotlinx/dataframe/DataFrame;Lkotlin/jvm/functions/Function2;)I
 	public static final fun sumShort (Lorg/jetbrains/kotlinx/dataframe/DataFrame;[Lkotlin/reflect/KProperty;)I
@@ -6477,8 +6479,7 @@ public final class org/jetbrains/kotlinx/dataframe/math/PercentileKt {
 }
 
 public final class org/jetbrains/kotlinx/dataframe/math/StdKt {
-	public static final fun std (Ljava/lang/Iterable;Lkotlin/reflect/KType;ZI)D
-	public static synthetic fun std$default (Ljava/lang/Iterable;Lkotlin/reflect/KType;ZIILjava/lang/Object;)D
+	public static final fun std (Lkotlin/sequences/Sequence;Lkotlin/reflect/KType;ZI)D
 }
 
 public final class org/jetbrains/kotlinx/dataframe/math/SumKt {

core/src/main/kotlin/org/jetbrains/kotlinx/dataframe/api/Defaults.kt

@@ -1,7 +1,18 @@
 package org.jetbrains.kotlinx.dataframe.api
 
 @PublishedApi
-internal val skipNaN_default: Boolean = false
+internal val skipNaNDefault: Boolean = false
 
+/**
+ * Default delta degrees of freedom for the standard deviation (std).
+ *
+ * The default is set to `1`,
+ * meaning DataFrame uses [Bessel’s correction](https://en.wikipedia.org/wiki/Bessel%27s_correction) to calculate the
+ * "unbiased sample standard deviation" by default.
+ * This is also the standard in languages like R.
+ *
+ * This is different from the "population standard deviation" (where `ddof = 0`),
+ * which is used in libraries like Numpy.
+ */
 @PublishedApi
-internal val ddof_default: Int = 1
+internal val ddofDefault: Int = 1