-
Notifications
You must be signed in to change notification settings - Fork 7
/
Copy pathREADME.win
162 lines (112 loc) · 6.18 KB
/
README.win
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
THE GETDATA PROJECT
===================
The GetData Project is the reference implementation of the Dirfile Standards.
The Dirfile database format is designed to provide a fast, simple format for
storing and reading binary time-ordered data. The Dirfile Standards are
described in detail in three manual pages distributed with this package:
man/dirfile.5.html
man/dirfile-format.5.html
man/dirfile-encoding.5.html
More information on the GetData Project and the Dirfile database format may be
found on the World Wide Web:
http://getdata.sourceforge.net/
WARRANTY AND REDISTRIBUTION
===========================
GetData is free software; you can redistribute it and/or modify it under the
terms of the GNU Lesser General Public License as published by the Free Software
Foundation: either version 2.1 of the License, or (at your option) any later
version.
GetData is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along
with GetData in a file called `COPYING'; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
CONTENTS
========
This package provides:
* the Dirfile Standards documents (three Unix manual pages in HTML)
* the C GetData library (libgetdata) including HTMLised Unix manual pages
* bindings to the library from C++ (libgetdata++)
Documentation for the various bindings, if present, can be found in files
named `README.<language>' in the doc/ directory. The C interface is described
in this document and the associated man pages.
A full list of features new to this release of GetData may be found in the
file called `NEWS'.
This package only provides a subset of the functionality of the full GetData
source code release, and is designed to be built on Microsoft Windows using
Microsoft Corporation's Visual C++ compiler, or else the open source MinGW
compiler. Notably missing in this package are bindings for Fortran, Python,
and the Interactive Data Language, the binary utilities (checkdirfile and
dirfile2ascii), support for external data encodings (compressed dirfiles),
and the C Library's C99 and Legacy APIs.
The full GetData source code release, which cannot be built (easily) by Visual
C++ (but can be built using MinGW, if the associated MSys shell is used) is
available from the World Wide Web; for details see:
http://getdata.sourceforge.net/
DIRFILE STANDARDS VERSION 10
============================
The 0.10.0 release of the GetData Library (January 2017) is the first release to
provide suuport the latest version of the Dirfile Standards, known as Standards
Version 10.
Standards Version 10 introduces the following:
* Three new field types: INDIR, SARRAY, and SINDIR.
* Field code namespaces.
* A new representation suffix, .z, which does nothing, which is occasionally
needed for disambiguation of syntax.
* Support for FLAC (Free Lossless Audio Compression) encoding of data.
(FLAC has been supported by GetData since 0.9.0.)
This is the first update to the Dirfile Standards since Standards Version 9
(July 2012). A full history of the Dirfile Standards can be found in the
BUILDING THE LIBRARY
====================
This package may be built using Kitware's CMake build system. Consult the CMake
documentation for generic instructions on using CMake. A brief summary follows.
This package supports building GetData using either Microsoft's Visual C++
compiler or else the free MinGW compiler, both which produce native Win32
binaries.
Best practice is to build outside the source tree. Call CMake in the build
folder and point it to the 'cmake' folder within the GetData source. For
instance, to create a project file for Microsoft Visual Studio 10 execute with
the command-line tool, try:
cmake -G"Visual Studio 10" ..\getdata-<version>\cmake
Then build the project as usual.
This package comes with a few utility programs in the util subdirectory. They
can be optionally built by setting the GD_UTIL variable:
cmake <path> -DGD_UTIL=1
The GetData test suit can be ebabled by setting the GD_TEST variable:
cmake <path> -DGD_TEST=1
In Visual Studio run the test by building the 'RUN_TESTS'. Using mingw
or nmake run the tests by calling ctest.
Verbose debugging output can be turned on by setting the GD_DEBUG variable:
cmake <path> -DGD_DEBUG=1
These debugging messages are typically only useful to people debugging GetData
itself. For release builds of GetData it should usually be left off, as they may
have a negative performance impact.
The install path can be set via the variable CMAKE_INSTALL_PREFIX.
By default it installs to <build-dir>/INSTALLED.
The file cmake/FindGetData.cmake may be used in projects managed by
CMake and which have to search for a GetData installation.
USING THE LIBRARY
=================
To use the library in C programs, the header file getdata.h should be included.
This file declares all the various APIs provided by the library.
The various small programs in the `util' subdirectory of the package provide
examples of use.
The checkdirfile utility was designed to report syntax errors in the format
file(s) of the large, complex dirfiles used in the analysis of the BLAST
experiment data. This utility will report all syntax errors it find in the
supplied dirfile, plus any problems in the metadata itself.
Bindings exist for using the GetData library in C++. Documentation for these
bindings is present in the README.cxx file in the `doc' subdirectory.
Bindings to the GetData library from Fortran, Perl, PHP, Python, and the
Interactive Data Language (IDL) have also been written, but not ported to
Microsoft Visual C++. If you are interested in these bindings, see the full
GetData source release.
AUTHOR
======
The Dirfile Standards and the GetData library were conceived and written by
C. B. Netterfield <[email protected]>.
Since Standards Version 3 (January 2006), the Dirfile Standards and GetData
have been maintained by D. V. Wiebe <[email protected]>.
A full list of contributors is given in the file called `AUTHORS'.