File: changes_to_c_api.rst

package info (click to toggle)
sep 1.4.1-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 1,484 kB
  • sloc: ansic: 5,051; python: 906; makefile: 259
file content (83 lines) | stat: -rw-r--r-- 2,549 bytes parent folder | download | duplicates (2)
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
81
82
83
Changes to the C API
====================

This page details cumulative changes to the C API between v1.2.1 and
v1.4.0, or since this package was forked from
`kbarbary/sep <https://github.com/kbarbary/sep>`_. Almost all changes to
the public API are to integer parameters, many of which have been changed
from ``int`` to ``int64_t``, to fix problems which may arise with
extremely large arrays. The other change of note is to the ``sep_image``
struct, which enables the user to pass an existing segmentation map, and
re-extract all morphological and photometric quantities on a different
image.

All changes here are transparent to users of the Python interface.

.. c:struct::  sep_image

 - Three new parameters have been added:

   .. c:var:: int64_t * segids

      The unique ids in an existing segmentation map.

   .. c:var:: int64_t * idcounts

      The number of occurrences of each unique id in an existing
      segmentation map.

   .. c:var:: int64_t numids

      The total number of unique ids in an existing segmentation map.

 - The type of ``w`` and ``h`` has changed from ``int`` to ``int64_t``.

.. c:struct:: sep_bkg

 - The type of the following parameters has changed from ``int`` to
   ``int64_t``: ``w``, ``h``, ``bw``, ``bh``, ``nx``, ``ny``, and ``n``.

.. c:struct:: sep_catalog

 - The type of the following parameters has changed from ``int`` to
   ``int64_t``: ``npix``, ``tnpix``, ``xmin``, ``xmax``, ``ymin``,
   ``ymax``, ``xcpeak``, ``ycpeak``, ``xpeak``, ``ypeak``, ``pix``, and
   ``objectspix``.

.. c:function:: int sep_background()

 - The type of the following parameters has changed from ``int`` to
   ``int64_t``: ``bw``, ``bh``, ``fw``, and ``fh``.

.. c:function:: float sep_bkg_pix()

 - The type of ``x`` and ``y`` has changed from ``int`` to ``int64_t``.

.. c:function:: int sep_bkg_line()

 - The type of ``y`` has changed from ``int`` to ``int64_t``.

.. c:function:: int sep_bkg_subline()

 - The type of ``y`` has changed from ``int`` to ``int64_t``.

.. c:function:: int sep_bkg_rmsline()

 - The type of ``y`` has changed from ``int`` to ``int64_t``.

.. c:function:: int sep_extract()

 - The type of ``convw`` and ``convh`` has changed from ``int`` to
   ``int64_t``.

.. c:function:: int sep_sum_circann_multi()

 - The type of ``n`` has changed from ``int`` to ``int64_t``.

.. c:function:: int sep_flux_radius()

 - The type of ``n`` has changed from ``int`` to ``int64_t``.

.. c:function:: void sep_set_ellipse()

 - The type of ``w`` and ``h`` has changed from ``int`` to ``int64_t``.