/usr/include/vl/hikmeans.h is in libvlfeat-dev 0.9.17+dfsg0-6+b1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 | /** @file hikmeans.h
** @brief Hierarchical Integer K-Means Clustering
** @author Brian Fulkerson
**/
/*
Copyright (C) 2007-12 Andrea Vedaldi and Brian Fulkerson.
All rights reserved.
This file is part of the VLFeat library and is made available under
the terms of the BSD license (see the COPYING file).
*/
#ifndef VL_HIKMEANS_H
#define VL_HIKMEANS_H
#include "generic.h"
#include "ikmeans.h"
struct _VLHIKMTree ;
struct _VLHIKMNode ;
/** @brief HIKM tree node
**
** The number of children @a K is not bigger than the @a K parameter
** of the HIKM tree.
**/
typedef struct _VlHIKMNode
{
VlIKMFilt *filter ; /**< IKM filter for this node*/
struct _VlHIKMNode **children ; /**< Node children (if any) */
} VlHIKMNode ;
/** @brief HIKM tree */
typedef struct _VlHIKMTree {
int M ; /**< IKM: data dimensionality */
int K ; /**< IKM: K */
int max_niters ; /**< IKM: maximum # of iterations */
int method ; /**< IKM: method */
int verb ; /**< Verbosity level */
int depth ; /**< Depth of the tree */
VlHIKMNode * root; /**< Tree root node */
} VlHIKMTree ;
/** @name Create and destroy
** @{
**/
VL_EXPORT VlHIKMTree *vl_hikm_new (int method) ;
VL_EXPORT void vl_hikm_delete (VlHIKMTree *f) ;
/** @} */
/** @name Retrieve data and parameters
** @{
**/
VL_INLINE int vl_hikm_get_ndims (VlHIKMTree const *f) ;
VL_INLINE int vl_hikm_get_K (VlHIKMTree const *f) ;
VL_INLINE int vl_hikm_get_depth (VlHIKMTree const *f) ;
VL_INLINE int vl_hikm_get_verbosity (VlHIKMTree const *f) ;
VL_INLINE int vl_hikm_get_max_niters (VlHIKMTree const *f) ;
VL_INLINE VlHIKMNode const * vl_hikm_get_root (VlHIKMTree const *f) ;
/** @} */
/** @name Set parameters
** @{
**/
VL_INLINE void vl_hikm_set_verbosity (VlHIKMTree *f, int verb) ;
VL_INLINE void vl_hikm_set_max_niters (VlHIKMTree *f, int max_niters) ;
/** @} */
/** @name Process data
** @{
**/
VL_EXPORT void vl_hikm_init (VlHIKMTree *f, int M, int K, int depth) ;
VL_EXPORT void vl_hikm_train (VlHIKMTree *f, vl_uint8 const *data, int N) ;
VL_EXPORT void vl_hikm_push (VlHIKMTree *f, vl_uint *asgn, vl_uint8 const *data, int N) ;
/** @} */
/** ------------------------------------------------------------------
** @brief Get data dimensionality
** @param f HIKM tree.
** @return data dimensionality.
**/
VL_INLINE int
vl_hikm_get_ndims (VlHIKMTree const* f)
{
return f-> M ;
}
/** ------------------------------------------------------------------
** @brief Get K
** @param f HIKM tree.
** @return K.
**/
VL_INLINE int
vl_hikm_get_K (VlHIKMTree const* f)
{
return f-> K ;
}
/** ------------------------------------------------------------------
** @brief Get depth
** @param f HIKM tree.
** @return depth.
**/
VL_INLINE int
vl_hikm_get_depth (VlHIKMTree const* f)
{
return f-> depth ;
}
/** ------------------------------------------------------------------
** @brief Get verbosity level
** @param f HIKM tree.
** @return verbosity level.
**/
VL_INLINE int
vl_hikm_get_verbosity (VlHIKMTree const* f)
{
return f-> verb ;
}
/** ------------------------------------------------------------------
** @brief Get maximum number of iterations
** @param f HIKM tree.
** @return maximum number of iterations.
**/
VL_INLINE int
vl_hikm_get_max_niters (VlHIKMTree const* f)
{
return f-> max_niters ;
}
/** ------------------------------------------------------------------
** @brief Get maximum number of iterations
** @param f HIKM tree.
** @return maximum number of iterations.
**/
VL_INLINE VlHIKMNode const *
vl_hikm_get_root (VlHIKMTree const* f)
{
return f-> root ;
}
/** ------------------------------------------------------------------
** @brief Set verbosity level
** @param f HIKM tree.
** @param verb verbosity level.
**/
VL_INLINE void
vl_hikm_set_verbosity (VlHIKMTree *f, int verb)
{
f-> verb = verb ;
}
/** ------------------------------------------------------------------
** @brief Set maximum number of iterations
** @param f HIKM tree.
** @param max_niters maximum number of iterations.
**/
VL_INLINE void
vl_hikm_set_max_niters (VlHIKMTree *f, int max_niters)
{
f-> max_niters = max_niters ;
}
/* VL_HIKMEANS_H */
#endif
|