@@ -29,7 +29,21 @@ The :doc:`datafile` and :doc:`image` guides describe the current interfaces.
2929These native computations do not automatically apply Stoner exclusions. Use
3030``to_numpy() `` for a detached masked numerical export, ``Data.asarray() `` or
3131``ImageFile.imarray `` for read-only numerical snapshots, and ``export_storage() ``
32- for lossless state with typed metadata. Broader wrapper simplification is Stage 9.
32+ for lossless state with typed metadata.
33+
34+ ``Data.head(n=5) `` and ``Data.tail(n=5) `` return independent objects of the same
35+ class, preserving raw excluded measurements, masks, dtype, fill value, column
36+ headers/roles/IDs and typed metadata. Negative counts omit rows from the opposite
37+ end; zero returns an empty table. Standard previews copy only selected numerical
38+ rows, while custom clone/deepcopy hooks retain their established behaviour.
39+
40+ ``Data.sort `` continues to sort in place and return the same object. Compatible
41+ real numeric keys now delegate to pandas stable sorting, with exclusions moved
42+ by the same row permutation. Complex values, other float widths, non-native byte
43+ orders and custom comparators retain numerical paths. ``reverse=True `` reverses
44+ the complete ascending permutation, including ties and NaNs. ``Data.unique ``
45+ retains NumPy's sorted masked results and optional index/inverse outputs because
46+ pandas distinct-value operations have different semantics.
3347
3448Direct native edits may change existing cells without changing dtype or geometry.
3549Use Stoner methods for structural changes, and reacquire native references after
0 commit comments