Skip to content

Commit 933c92b

Browse files
committed
docs: Update changelog
1 parent 4a93f68 commit 933c92b

File tree

1 file changed

+6
-1
lines changed

1 file changed

+6
-1
lines changed

Diff for: CHANGES.md

+6-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,12 @@
66
Date 2024-01-08
77

88
API changes:
9-
* `overlap`: Default behavior of overlap was changed to minimize the possibility of regressions in libraries that depend on legacy behavior. The new option `ensure_nullable` is renamed `ensure_int` and is `True` by default. It ensures that output coordinate columns are always returned with an integer dtype, as was the case in prior versions. This is achieved by converting columns having non-nullable NumPy dtypes to Pandas nullable ones in the specific case where the result of an **outer** join generates missing values; otherwise, column dtypes are preserved unchanged in the output. Unlike previous minor versions of bioframe, the nullable dtype chosen will have the same underlying type as the corresponding column from the input (i.e, an input dataframe using `np.uint32` start coordinates may yield a `pd.UInt32` start column in the output). This behavior can be turned off by setting `ensure_int` to `False`, in which case outer joins on dataframes using NumPy dtypes may produce floating point output columns when missing values are introduced as `NaN`, following the native casting behavior of such columns.
9+
10+
Default behavior of `ensure_nullable` option in `overlap` was modified to minimize the possibility of regressions in libraries that depend on legacy behavior.
11+
12+
* The new option was renamed `ensure_int` and is `True` by default. It ensures that output coordinate columns are always returned with an integer dtype, as was the case in prior versions. This is achieved by converting columns having non-nullable NumPy dtypes to Pandas nullable ones in the specific case where the result of an **outer join** generates missing values; otherwise, column dtypes are preserved unchanged in the output.
13+
* Unlike previous minor versions of bioframe, the nullable dtype chosen will have the **same underlying type** as the corresponding column from the input (i.e, an input dataframe using `np.uint32` start coordinates may yield a `pd.UInt32` start column in the output).
14+
* This behavior can be turned off by setting `ensure_int` to `False`, in which case outer joins on dataframes using NumPy dtypes may produce floating point output columns when missing values are introduced (stored as `NaN`), following the native casting behavior of such columns.
1015

1116
## [v0.6.0](https://github.com/open2c/bioframe/compare/v0.5.1...v0.6.0)
1217
Date 2024-01-04

0 commit comments

Comments
 (0)