X-Git-Url: http://woldlab.caltech.edu/gitweb/?p=pysam.git;a=blobdiff_plain;f=tabix%2Ftabix.h;fp=tabix%2Ftabix.h;h=4390c0918023936c5e8f17016d6f5532ac84b313;hp=0000000000000000000000000000000000000000;hb=6a7c3f175b210cc16d09a5e8e4c1d47333dbe1c6;hpb=aa8ecff068edbb09a03bd874fce716e93e22e53c

diff --git a/tabix/tabix.h b/tabix/tabix.h
new file mode 100644
index 0000000..4390c09
--- /dev/null
+++ b/tabix/tabix.h
@@ -0,0 +1,137 @@
+/* The MIT License
+
+   Copyright (c) 2009 Genome Research Ltd (GRL), 2010 Broad Institute
+
+   Permission is hereby granted, free of charge, to any person obtaining
+   a copy of this software and associated documentation files (the
+   "Software"), to deal in the Software without restriction, including
+   without limitation the rights to use, copy, modify, merge, publish,
+   distribute, sublicense, and/or sell copies of the Software, and to
+   permit persons to whom the Software is furnished to do so, subject to
+   the following conditions:
+
+   The above copyright notice and this permission notice shall be
+   included in all copies or substantial portions of the Software.
+
+   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+   EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+   MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+   NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
+   BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+   ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+   CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+   SOFTWARE.
+*/
+
+/* Contact: Heng Li <lh3@live.co.uk> */
+
+#ifndef __TABIDX_H
+#define __TABIDX_H
+
+#include <stdint.h>
+#include "kstring.h"
+#include "bgzf.h"
+
+#define TI_PRESET_GENERIC 0
+#define TI_PRESET_SAM     1
+#define TI_PRESET_VCF     2
+
+#define TI_FLAG_UCSC      0x10000
+
+typedef int (*ti_fetch_f)(int l, const char *s, void *data);
+
+struct __ti_index_t;
+typedef struct __ti_index_t ti_index_t;
+
+struct __ti_iter_t;
+typedef struct __ti_iter_t *ti_iter_t;
+
+typedef struct {
+	BGZF *fp;
+	ti_index_t *idx;
+	char *fn, *fnidx;
+} tabix_t;
+
+typedef struct {
+	int32_t preset;
+	int32_t sc, bc, ec; // seq col., beg col. and end col.
+	int32_t meta_char, line_skip;
+} ti_conf_t;
+
+extern ti_conf_t ti_conf_gff, ti_conf_bed, ti_conf_psltbl, ti_conf_vcf, ti_conf_sam; // preset
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+	/*******************
+	 * High-level APIs *
+	 *******************/
+
+	tabix_t *ti_open(const char *fn, const char *fnidx);
+	int ti_lazy_index_load(tabix_t *t);
+	void ti_close(tabix_t *t);
+	ti_iter_t ti_query(tabix_t *t, const char *name, int beg, int end);
+	ti_iter_t ti_queryi(tabix_t *t, int tid, int beg, int end);
+	ti_iter_t ti_querys(tabix_t *t, const char *reg);
+	const char *ti_read(tabix_t *t, ti_iter_t iter, int *len);
+
+	/* Destroy the iterator */
+	void ti_iter_destroy(ti_iter_t iter);
+
+	/* Get the list of sequence names. Each "char*" pointer points to a
+	 * internal member of the index, so DO NOT modify the returned
+	 * pointer; otherwise the index will be corrupted. The returned
+	 * pointer should be freed by a single free() call by the routine
+	 * calling this function. The number of sequences is returned at *n. */
+	const char **ti_seqname(const ti_index_t *idx, int *n);
+
+	/******************
+	 * Low-level APIs *
+	 ******************/
+
+	/* Build the index for file <fn>. File <fn>.tbi will be generated
+	 * and overwrite the file of the same name. Return -1 on failure. */
+	int ti_index_build(const char *fn, const ti_conf_t *conf);
+
+	/* Load the index from file <fn>.tbi. If <fn> is a URL and the index
+	 * file is not in the working directory, <fn>.tbi will be
+	 * downloaded. Return NULL on failure. */
+	ti_index_t *ti_index_load(const char *fn);
+
+	ti_index_t *ti_index_load_local(const char *fnidx);
+
+	/* Destroy the index */
+	void ti_index_destroy(ti_index_t *idx);
+
+	/* Parse a region like: chr2, chr2:100, chr2:100-200. Return -1 on failure. */
+	int ti_parse_region(const ti_index_t *idx, const char *str, int *tid, int *begin, int *end);
+
+	int ti_get_tid(const ti_index_t *idx, const char *name);
+
+	/* Get the iterator pointing to the first record at the current file
+	 * position. If the file is just openned, the iterator points to the
+	 * first record in the file. */
+	ti_iter_t ti_iter_first(void);
+
+	/* Get the iterator pointing to the first record in region tid:beg-end */
+	ti_iter_t ti_iter_query(const ti_index_t *idx, int tid, int beg, int end);
+
+	/* Get the data line pointed by the iterator and iterate to the next record. */
+	const char *ti_iter_read(BGZF *fp, ti_iter_t iter, int *len);
+
+	/*******************
+	 * Deprecated APIs *
+	 *******************/
+
+	/* The callback version for random access */
+	int ti_fetch(BGZF *fp, const ti_index_t *idx, int tid, int beg, int end, void *data, ti_fetch_f func);
+
+	/* Read one line. */
+	int ti_readline(BGZF *fp, kstring_t *str);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif