plot-io 0.12.0__py3-none-win_arm64.whl

plot_io/_native/_api.py

@@ -0,0 +1,457 @@
+"""Bindings of plot_io's C library, generated by tools/build_native.py from
+src/plio_api.h: do not edit."""
+
+import ctypes
+from ctypes import POINTER, c_double, c_int32, c_int64, c_void_p
+
+__all__ = ["ABI_VERSION", "CODES", "ERRORS", "FUNCTIONS", "STRUCTS", "SIGNATURE_TEXT"]
+
+ABI_VERSION = 5
+
+#: Error codes: code -> message.
+ERRORS = {
+    -3: 'invalid argument',   # PLIO_E_ARG
+    -4: 'unsupported input',   # PLIO_E_UNSUPPORTED
+    -5: 'out of memory',   # PLIO_E_NOMEM
+    -6: 'size limit exceeded',   # PLIO_E_LIMIT
+    -7: 'parameter structure of the wrong size',   # PLIO_E_STRUCT
+}
+
+E_ARG = -3
+E_UNSUPPORTED = -4
+E_NOMEM = -5
+E_LIMIT = -6
+E_STRUCT = -7
+
+#: Codes of function arguments: group -> lowercase name -> code.
+CODES = {
+    "MATH": {"floor": 0, "ceil": 1, "sqrt": 2, "exp": 3, "log": 4, "pow": 5, "sin": 6, "cos": 7},
+    "FN": {"none": 0, "log": 1, "log2": 2, "log10": 3, "sqrt": 4, "exp": 5, "symlog": 6, "logit": 7},
+    "WHISKERS": {"iqr": 0, "range": 1, "percentiles": 2},
+    "CMAP": {"linear": 0, "smooth": 1, "spline": 2},
+    "SPACE": {"srgb": 0, "oklab": 1},
+    "METRIC": {"euclidean": 0, "sqeuclidean": 1, "cityblock": 2, "chebyshev": 3, "cosine": 4, "correlation": 5, "precomputed": 6},
+    "LINKAGE": {"single": 0, "complete": 1, "average": 2, "weighted": 3, "ward": 4, "centroid": 5, "median": 6},
+}
+
+MATH_FLOOR = 0
+MATH_CEIL = 1
+MATH_SQRT = 2
+MATH_EXP = 3
+MATH_LOG = 4
+MATH_POW = 5
+MATH_SIN = 6
+MATH_COS = 7
+FN_NONE = 0
+FN_LOG = 1
+FN_LOG2 = 2
+FN_LOG10 = 3
+FN_SQRT = 4
+FN_EXP = 5
+FN_SYMLOG = 6
+FN_LOGIT = 7
+WHISKERS_IQR = 0
+WHISKERS_RANGE = 1
+WHISKERS_PERCENTILES = 2
+CMAP_LINEAR = 0
+CMAP_SMOOTH = 1
+CMAP_SPLINE = 2
+SPACE_SRGB = 0
+SPACE_OKLAB = 1
+METRIC_EUCLIDEAN = 0
+METRIC_SQEUCLIDEAN = 1
+METRIC_CITYBLOCK = 2
+METRIC_CHEBYSHEV = 3
+METRIC_COSINE = 4
+METRIC_CORRELATION = 5
+METRIC_PRECOMPUTED = 6
+LINKAGE_SINGLE = 0
+LINKAGE_COMPLETE = 1
+LINKAGE_AVERAGE = 2
+LINKAGE_WEIGHTED = 3
+LINKAGE_WARD = 4
+LINKAGE_CENTROID = 5
+LINKAGE_MEDIAN = 6
+
+
+class _Params(ctypes.Structure):
+    """A parameter structure: ``size`` is set on creation."""
+
+    def __init__(self, *args, **kw):
+        super().__init__(ctypes.sizeof(self), *args, **kw)
+
+
+class Ctx(_Params):
+    _fields_ = [
+        ("size", c_int64),
+        ("malloc", c_void_p),
+        ("realloc", c_void_p),
+        ("free", c_void_p),
+        ("message", c_void_p),
+        ("message_size", c_int64),
+    ]
+
+
+class Scale(_Params):
+    _fields_ = [
+        ("size", c_int64),
+        ("function", c_int32),
+        ("has_nan", c_int32),
+        ("has_below", c_int32),
+        ("has_above", c_int32),
+        ("scale", c_double),
+        ("offset", c_double),
+        ("linthresh", c_double),
+        ("low", c_double),
+        ("high", c_double),
+        ("under", c_double),
+        ("over", c_double),
+        ("nan_value", c_double),
+        ("below", c_double),
+        ("above", c_double),
+    ]
+
+
+class Whiskers(_Params):
+    _fields_ = [
+        ("size", c_int64),
+        ("mode", c_int32),
+        ("reserved", c_int32),
+        ("a", c_double),
+        ("b", c_double),
+    ]
+
+
+class Summary(_Params):
+    _fields_ = [
+        ("size", c_int64),
+        ("rows", c_int64),
+        ("cols", c_int64),
+        ("groups", c_int64),
+        ("threshold", c_double),
+        ("group", c_void_p),
+    ]
+
+
+class Stops(_Params):
+    _fields_ = [
+        ("size", c_int64),
+        ("m", c_int32),
+        ("mode", c_int32),
+        ("space", c_int32),
+        ("reserved", c_int32),
+        ("pos", c_void_p),
+        ("rgba", c_void_p),
+    ]
+
+
+class Lookup(_Params):
+    _fields_ = [
+        ("size", c_int64),
+        ("m", c_int32),
+        ("flags", c_int32),
+        ("table", c_void_p),
+        ("steps", c_void_p),
+        ("under", c_double * 4),
+        ("over", c_double * 4),
+        ("bad", c_double * 4),
+    ]
+
+
+class CellMap(_Params):
+    _fields_ = [
+        ("size", c_int64),
+        ("lo", c_double),
+        ("hi", c_double),
+        ("levels", c_int32),
+        ("split", c_int32),
+    ]
+
+
+class Points(_Params):
+    _fields_ = [
+        ("size", c_int64),
+        ("n", c_int64),
+        ("x", c_void_p),
+        ("y", c_void_p),
+        ("w", c_void_p),
+    ]
+
+
+class Hexgrid(_Params):
+    _fields_ = [
+        ("size", c_int64),
+        ("nx", c_int32),
+        ("ny", c_int32),
+        ("x0", c_double),
+        ("y0", c_double),
+        ("dx", c_double),
+        ("dy", c_double),
+    ]
+
+
+class KdeGrid(_Params):
+    _fields_ = [
+        ("size", c_int64),
+        ("m", c_int32),
+        ("cumulative", c_int32),
+        ("lo", c_double),
+        ("hi", c_double),
+        ("bw", c_double),
+    ]
+
+
+class Kernel2d(_Params):
+    _fields_ = [
+        ("size", c_int64),
+        ("h11", c_double),
+        ("h12", c_double),
+        ("h22", c_double),
+    ]
+
+
+class Blur(_Params):
+    _fields_ = [
+        ("size", c_int64),
+        ("rows", c_int64),
+        ("cols", c_int64),
+        ("L", c_int64),
+        ("delta", c_double),
+        ("var", c_double),
+    ]
+
+
+class Grid(_Params):
+    _fields_ = [
+        ("size", c_int64),
+        ("w", c_int32),
+        ("h", c_int32),
+        ("g", c_void_p),
+        ("xs", c_void_p),
+        ("ys", c_void_p),
+    ]
+
+
+class LowessArgs(_Params):
+    _fields_ = [
+        ("size", c_int64),
+        ("iterations", c_int32),
+        ("reserved", c_int32),
+        ("frac", c_double),
+        ("delta", c_double),
+    ]
+
+
+class LinkageArgs(_Params):
+    _fields_ = [
+        ("size", c_int64),
+        ("n", c_int64),
+        ("d", c_int64),
+        ("method", c_int32),
+        ("metric", c_int32),
+        ("data", c_void_p),
+    ]
+
+
+#: Structure name in C -> ctypes class.
+STRUCTS = {
+    "plio_ctx": Ctx,
+    "plio_scale": Scale,
+    "plio_whiskers": Whiskers,
+    "plio_summary": Summary,
+    "plio_stops": Stops,
+    "plio_lookup": Lookup,
+    "plio_cell_map": CellMap,
+    "plio_points": Points,
+    "plio_hexgrid": Hexgrid,
+    "plio_kde_grid": KdeGrid,
+    "plio_kernel2d": Kernel2d,
+    "plio_blur": Blur,
+    "plio_grid": Grid,
+    "plio_lowess_args": LowessArgs,
+    "plio_linkage_args": LinkageArgs,
+}
+
+#: Exported functions: name -> (restype, argtypes).
+FUNCTIONS = {
+    "plio_abi_version": (c_int32, []),
+    "plio_free": (None, [POINTER(Ctx), c_void_p]),
+    "plio_signatures": (c_int64, [POINTER(Ctx), POINTER(c_void_p), POINTER(c_void_p)]),
+    "plio_math_eval": (c_int64, [POINTER(Ctx), c_int32, c_void_p, c_void_p, c_void_p, c_int64]),
+    "plio_scaled": (c_int64, [POINTER(Ctx), POINTER(Scale), c_void_p, c_int64, c_void_p]),
+    "plio_extent": (c_int64, [POINTER(Ctx), c_void_p, c_int64, c_int32, c_void_p]),
+    "plio_quantiles": (c_int64, [POINTER(Ctx), c_void_p, c_int64, c_void_p, c_int32, c_void_p]),
+    "plio_box_stats": (c_int64, [POINTER(Ctx), POINTER(Whiskers), c_void_p, c_int64, c_void_p, POINTER(c_void_p), c_void_p]),
+    "plio_argsort": (c_int64, [POINTER(Ctx), c_void_p, c_int64, c_int32, c_void_p]),
+    "plio_take": (c_int64, [POINTER(Ctx), c_void_p, c_int64, c_int32, c_void_p, c_int64, c_void_p]),
+    "plio_group_summary": (c_int64, [POINTER(Ctx), POINTER(Summary), c_void_p, c_void_p]),
+    "plio_colormap_eval": (c_int64, [POINTER(Ctx), POINTER(Stops), c_void_p, c_int64, c_void_p]),
+    "plio_colors_at": (c_int64, [POINTER(Ctx), POINTER(Lookup), c_void_p, c_int64, c_void_p]),
+    "plio_cells": (c_int64, [POINTER(Ctx), POINTER(CellMap), c_void_p, c_int64, c_void_p]),
+    "plio_histogram": (c_int64, [POINTER(Ctx), c_void_p, c_int64, c_void_p, c_void_p, c_int32, c_void_p]),
+    "plio_histogram2d": (c_int64, [POINTER(Ctx), POINTER(Points), c_void_p, c_int32, c_void_p, c_int32, c_void_p]),
+    "plio_hexbin": (c_int64, [POINTER(Ctx), POINTER(Points), POINTER(Hexgrid), c_void_p]),
+    "plio_moments": (c_int64, [POINTER(Ctx), c_void_p, c_void_p, c_int64, c_void_p]),
+    "plio_moments2": (c_int64, [POINTER(Ctx), POINTER(Points), c_void_p]),
+    "plio_ecdf": (c_int64, [POINTER(Ctx), c_void_p, c_void_p, c_int64, c_void_p, c_void_p]),
+    "plio_kde": (c_int64, [POINTER(Ctx), POINTER(KdeGrid), c_void_p, c_void_p, c_int64, c_void_p]),
+    "plio_kde2d_exact": (c_int64, [POINTER(Ctx), POINTER(Points), POINTER(Kernel2d), c_void_p, c_void_p, c_int64, c_void_p]),
+    "plio_kde2d_setup": (c_int64, [POINTER(Ctx), POINTER(Points), POINTER(Kernel2d), c_int32, c_void_p]),
+    "plio_kde2d_bin": (c_int64, [POINTER(Ctx), POINTER(Points), c_void_p, c_void_p]),
+    "plio_kde2d_blur": (c_int64, [POINTER(Ctx), POINTER(Blur), c_void_p, c_void_p, c_int64, c_int64]),
+    "plio_transpose": (c_int64, [POINTER(Ctx), c_void_p, c_void_p, c_int64, c_int64]),
+    "plio_kde2d_sample": (c_int64, [POINTER(Ctx), c_void_p, c_void_p, c_void_p, c_void_p, c_int64, c_void_p]),
+    "plio_contour_lines": (c_int64, [POINTER(Ctx), POINTER(Grid), c_double, POINTER(c_void_p), POINTER(c_void_p), POINTER(c_void_p)]),
+    "plio_contour_bands": (c_int64, [POINTER(Ctx), POINTER(Grid), c_double, c_double, POINTER(c_void_p), POINTER(c_void_p)]),
+    "plio_lowess": (c_int64, [POINTER(Ctx), POINTER(LowessArgs), c_void_p, c_void_p, c_int64, c_void_p]),
+    "plio_swarm": (c_int64, [POINTER(Ctx), c_void_p, c_void_p, c_int32, c_int64, c_double, c_void_p]),
+    "plio_linkage": (c_int64, [POINTER(Ctx), POINTER(LinkageArgs), POINTER(c_void_p)]),
+}
+
+#: What plio_signatures() must report, line by line.
+SIGNATURE_TEXT = (
+    "f plio_abi_version i \n"
+    "f plio_free v Splio_ctx,p\n"
+    "f plio_signatures q Splio_ctx,P,P\n"
+    "f plio_math_eval q Splio_ctx,i,p,p,p,q\n"
+    "f plio_scaled q Splio_ctx,Splio_scale,p,q,p\n"
+    "f plio_extent q Splio_ctx,p,q,i,p\n"
+    "f plio_quantiles q Splio_ctx,p,q,p,i,p\n"
+    "f plio_box_stats q Splio_ctx,Splio_whiskers,p,q,p,P,p\n"
+    "f plio_argsort q Splio_ctx,p,q,i,p\n"
+    "f plio_take q Splio_ctx,p,q,i,p,q,p\n"
+    "f plio_group_summary q Splio_ctx,Splio_summary,p,p\n"
+    "f plio_colormap_eval q Splio_ctx,Splio_stops,p,q,p\n"
+    "f plio_colors_at q Splio_ctx,Splio_lookup,p,q,p\n"
+    "f plio_cells q Splio_ctx,Splio_cell_map,p,q,p\n"
+    "f plio_histogram q Splio_ctx,p,q,p,p,i,p\n"
+    "f plio_histogram2d q Splio_ctx,Splio_points,p,i,p,i,p\n"
+    "f plio_hexbin q Splio_ctx,Splio_points,Splio_hexgrid,p\n"
+    "f plio_moments q Splio_ctx,p,p,q,p\n"
+    "f plio_moments2 q Splio_ctx,Splio_points,p\n"
+    "f plio_ecdf q Splio_ctx,p,p,q,p,p\n"
+    "f plio_kde q Splio_ctx,Splio_kde_grid,p,p,q,p\n"
+    "f plio_kde2d_exact q Splio_ctx,Splio_points,Splio_kernel2d,p,p,q,p\n"
+    "f plio_kde2d_setup q Splio_ctx,Splio_points,Splio_kernel2d,i,p\n"
+    "f plio_kde2d_bin q Splio_ctx,Splio_points,p,p\n"
+    "f plio_kde2d_blur q Splio_ctx,Splio_blur,p,p,q,q\n"
+    "f plio_transpose q Splio_ctx,p,p,q,q\n"
+    "f plio_kde2d_sample q Splio_ctx,p,p,p,p,q,p\n"
+    "f plio_contour_lines q Splio_ctx,Splio_grid,d,P,P,P\n"
+    "f plio_contour_bands q Splio_ctx,Splio_grid,d,d,P,P\n"
+    "f plio_lowess q Splio_ctx,Splio_lowess_args,p,p,q,p\n"
+    "f plio_swarm q Splio_ctx,p,p,i,q,d,p\n"
+    "f plio_linkage q Splio_ctx,Splio_linkage_args,P\n"
+    "s plio_ctx\n"
+    "m plio_ctx.size q\n"
+    "m plio_ctx.malloc p\n"
+    "m plio_ctx.realloc p\n"
+    "m plio_ctx.free p\n"
+    "m plio_ctx.message p\n"
+    "m plio_ctx.message_size q\n"
+    "s plio_scale\n"
+    "m plio_scale.size q\n"
+    "m plio_scale.function i\n"
+    "m plio_scale.has_nan i\n"
+    "m plio_scale.has_below i\n"
+    "m plio_scale.has_above i\n"
+    "m plio_scale.scale d\n"
+    "m plio_scale.offset d\n"
+    "m plio_scale.linthresh d\n"
+    "m plio_scale.low d\n"
+    "m plio_scale.high d\n"
+    "m plio_scale.under d\n"
+    "m plio_scale.over d\n"
+    "m plio_scale.nan_value d\n"
+    "m plio_scale.below d\n"
+    "m plio_scale.above d\n"
+    "s plio_whiskers\n"
+    "m plio_whiskers.size q\n"
+    "m plio_whiskers.mode i\n"
+    "m plio_whiskers.reserved i\n"
+    "m plio_whiskers.a d\n"
+    "m plio_whiskers.b d\n"
+    "s plio_summary\n"
+    "m plio_summary.size q\n"
+    "m plio_summary.rows q\n"
+    "m plio_summary.cols q\n"
+    "m plio_summary.groups q\n"
+    "m plio_summary.threshold d\n"
+    "m plio_summary.group p\n"
+    "s plio_stops\n"
+    "m plio_stops.size q\n"
+    "m plio_stops.m i\n"
+    "m plio_stops.mode i\n"
+    "m plio_stops.space i\n"
+    "m plio_stops.reserved i\n"
+    "m plio_stops.pos p\n"
+    "m plio_stops.rgba p\n"
+    "s plio_lookup\n"
+    "m plio_lookup.size q\n"
+    "m plio_lookup.m i\n"
+    "m plio_lookup.flags i\n"
+    "m plio_lookup.table p\n"
+    "m plio_lookup.steps p\n"
+    "m plio_lookup.under d[4]\n"
+    "m plio_lookup.over d[4]\n"
+    "m plio_lookup.bad d[4]\n"
+    "s plio_cell_map\n"
+    "m plio_cell_map.size q\n"
+    "m plio_cell_map.lo d\n"
+    "m plio_cell_map.hi d\n"
+    "m plio_cell_map.levels i\n"
+    "m plio_cell_map.split i\n"
+    "s plio_points\n"
+    "m plio_points.size q\n"
+    "m plio_points.n q\n"
+    "m plio_points.x p\n"
+    "m plio_points.y p\n"
+    "m plio_points.w p\n"
+    "s plio_hexgrid\n"
+    "m plio_hexgrid.size q\n"
+    "m plio_hexgrid.nx i\n"
+    "m plio_hexgrid.ny i\n"
+    "m plio_hexgrid.x0 d\n"
+    "m plio_hexgrid.y0 d\n"
+    "m plio_hexgrid.dx d\n"
+    "m plio_hexgrid.dy d\n"
+    "s plio_kde_grid\n"
+    "m plio_kde_grid.size q\n"
+    "m plio_kde_grid.m i\n"
+    "m plio_kde_grid.cumulative i\n"
+    "m plio_kde_grid.lo d\n"
+    "m plio_kde_grid.hi d\n"
+    "m plio_kde_grid.bw d\n"
+    "s plio_kernel2d\n"
+    "m plio_kernel2d.size q\n"
+    "m plio_kernel2d.h11 d\n"
+    "m plio_kernel2d.h12 d\n"
+    "m plio_kernel2d.h22 d\n"
+    "s plio_blur\n"
+    "m plio_blur.size q\n"
+    "m plio_blur.rows q\n"
+    "m plio_blur.cols q\n"
+    "m plio_blur.L q\n"
+    "m plio_blur.delta d\n"
+    "m plio_blur.var d\n"
+    "s plio_grid\n"
+    "m plio_grid.size q\n"
+    "m plio_grid.w i\n"
+    "m plio_grid.h i\n"
+    "m plio_grid.g p\n"
+    "m plio_grid.xs p\n"
+    "m plio_grid.ys p\n"
+    "s plio_lowess_args\n"
+    "m plio_lowess_args.size q\n"
+    "m plio_lowess_args.iterations i\n"
+    "m plio_lowess_args.reserved i\n"
+    "m plio_lowess_args.frac d\n"
+    "m plio_lowess_args.delta d\n"
+    "s plio_linkage_args\n"
+    "m plio_linkage_args.size q\n"
+    "m plio_linkage_args.n q\n"
+    "m plio_linkage_args.d q\n"
+    "m plio_linkage_args.method i\n"
+    "m plio_linkage_args.metric i\n"
+    "m plio_linkage_args.data p\n"
+)