File: Statistics.py

package info (click to toggle)
ngs-sdk 2.9.3-1
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 8,216 kB
  • sloc: cpp: 20,310; java: 5,060; perl: 3,895; python: 1,452; makefile: 691; xml: 233; sh: 70
file content (128 lines) | stat: -rw-r--r-- 4,653 bytes parent folder | download | duplicates (7)
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
# ===========================================================================
# 
#                            PUBLIC DOMAIN NOTICE
#               National Center for Biotechnology Information
# 
#  This software/database is a "United States Government Work" under the
#  terms of the United States Copyright Act.  It was written as part of
#  the author's official duties as a United States Government employee and
#  thus cannot be copyrighted.  This software/database is freely available
#  to the public for use. The National Library of Medicine and the U.S.
#  Government have not placed any restriction on its use or reproduction.
# 
#  Although all reasonable efforts have been taken to ensure the accuracy
#  and reliability of the software and data, the NLM and the U.S.
#  Government do not and cannot warrant the performance or results that
#  may be obtained by using this software or data. The NLM and the U.S.
#  Government disclaim all warranties, express or implied, including
#  warranties of performance, merchantability or fitness for any particular
#  purpose.
# 
#  Please cite the author in any work or product based on this material.
# 
# ===========================================================================
# 
# 

from ctypes import byref, c_uint32, c_int64, c_uint64, c_double
from . import NGS

from .String import NGS_String, NGS_RawString, getNGSString, getNGSValue
from .Refcount import Refcount

# Statistical data container

class Statistics(Refcount):
    none   = 0
    string = 1
    int64  = 2
    uint64 = 3
    real   = 4

    def getValueType(self, path):
        ret = c_uint32()
        ngs_str_err = NGS_RawString()
        try:
            res = NGS.lib_manager.PY_NGS_StatisticsGetValueType(self.ref, path, byref(ret), byref(ngs_str_err.ref))
        finally:
            ngs_str_err.close()
        
        return ret.value

    def getAsString(self, path):
        """
        :param: path is hierarchical path to value node
        :returns: textual representation of value
        :throws: ErrorMsg if path not found or value cannot be converted
        """
        ngs_str_err = NGS_RawString()
        try:
            ngs_str_ret = NGS_String()
            try:
                res = NGS.lib_manager.PY_NGS_StatisticsGetAsString(self.ref, path, byref(ngs_str_ret.ref), byref(ngs_str_err.ref))
                return ngs_str_ret.getPyString()
            finally:
                ngs_str_ret.close()
        finally:
            ngs_str_err.close()

    def getAsI64(self, path):
        """
        :param: path is hierarchical path to value node
        :returns: a signed 64-bit integer
        :throws: ErrorMsg if path not found or value cannot be converted
        """
        ret = c_int64()
        ngs_str_err = NGS_RawString()
        try:
            res = NGS.lib_manager.PY_NGS_StatisticsGetAsI64(self.ref, path, byref(ret), byref(ngs_str_err.ref))
        finally:
            ngs_str_err.close()
        
        return ret.value

    def getAsU64(self, path):
        """
        :param: path is hierarchical path to value node
        :returns: a non-negative 64-bit integer
        :throws: ErrorMsg if path not found or value cannot be converted
        """
        ret = c_uint64()
        ngs_str_err = NGS_RawString()
        try:
            res = NGS.lib_manager.PY_NGS_StatisticsGetAsU64(self.ref, path.encode("UTF-8"), byref(ret), byref(ngs_str_err.ref))
        finally:
            ngs_str_err.close()
        
        return ret.value

    def getAsDouble(self, path):
        """
        :param: path is hierarchical path to value node
        :returns: a 64-bit floating point
        :throws: ErrorMsg if path not found or value cannot be converted
        """
        ret = c_double()
        ngs_str_err = NGS_RawString()
        try:
            res = NGS.lib_manager.PY_NGS_StatisticsGetAsDouble(self.ref, path, byref(ret), byref(ngs_str_err.ref))
        finally:
            ngs_str_err.close()
        
        return ret.value

    def nextPath(self, path):
        """advance to next path in container
        :param: path is null or empty to request first path, or a valid path string
        :returns: null if no more paths, or a valid path string
        """
        ngs_str_err = NGS_RawString()
        try:
            ngs_str_ret = NGS_String()
            try:
                res = NGS.lib_manager.PY_NGS_StatisticsGetNextPath(self.ref, path, byref(ngs_str_ret.ref), byref(ngs_str_err.ref))
                return ngs_str_ret.getPyString()
            finally:
                ngs_str_ret.close()
        finally:
            ngs_str_err.close()