sam_view.c

   1 #include <stdlib.h>
   2 #include <string.h>
   3 #include <stdio.h>
   4 #include <unistd.h>
   5 #include "sam.h"
   6
   7 static int g_min_mapQ = 0, g_flag_on = 0, g_flag_off = 0;
   8 static char *g_library, *g_rg;
   9
  10 static inline int __g_skip_aln(const bam_header_t *h, const bam1_t *b)
  11 {
  12         if (b->core.qual < g_min_mapQ || ((b->core.flag & g_flag_on) != g_flag_on) || (b->core.flag & g_flag_off))
  13                 return 1;
  14         if (g_library || g_rg) {
  15                 uint8_t *s = bam_aux_get(b, "RG");
  16                 if (s) {
  17                         if (g_rg && strcmp(g_rg, (char*)(s + 1)) == 0) return 0;
  18                         if (g_library) {
  19                                 const char *p = bam_strmap_get(h->rg2lib, (char*)(s + 1));
  20                                 return (p && strcmp(p, g_library) == 0)? 0 : 1;
  21                         } return 1;
  22                 } else return 1;
  23         } else return 0;
  24 }
  25
  26 // callback function for bam_fetch()
  27 static int view_func(const bam1_t *b, void *data)
  28 {
  29         if (!__g_skip_aln(((samfile_t*)data)->header, b))
  30                 samwrite((samfile_t*)data, b);
  31         return 0;
  32 }
  33
  34 static int usage(void);
  35
  36 int main_samview(int argc, char *argv[])
  37 {
  38         int c, is_header = 0, is_header_only = 0, is_bamin = 1, ret = 0, is_uncompressed = 0, is_bamout = 0;
  39         int of_type = BAM_OFDEC;
  40         samfile_t *in = 0, *out = 0;
  41         char in_mode[5], out_mode[5], *fn_out = 0, *fn_list = 0;
  42
  43         /* parse command-line options */
  44         strcpy(in_mode, "r"); strcpy(out_mode, "w");
  45         while ((c = getopt(argc, argv, "Sbt:hHo:q:f:F:ul:r:xX")) >= 0) {
  46                 switch (c) {
  47                 case 'S': is_bamin = 0; break;
  48                 case 'b': is_bamout = 1; break;
  49                 case 't': fn_list = strdup(optarg); is_bamin = 0; break;
  50                 case 'h': is_header = 1; break;
  51                 case 'H': is_header_only = 1; break;
  52                 case 'o': fn_out = strdup(optarg); break;
  53                 case 'f': g_flag_on = strtol(optarg, 0, 0); break;
  54                 case 'F': g_flag_off = strtol(optarg, 0, 0); break;
  55                 case 'q': g_min_mapQ = atoi(optarg); break;
  56                 case 'u': is_uncompressed = 1; break;
  57                 case 'l': g_library = strdup(optarg); break;
  58                 case 'r': g_rg = strdup(optarg); break;
  59                 case 'x': of_type = BAM_OFHEX; break;
  60                 case 'X': of_type = BAM_OFSTR; break;
  61                 default: return usage();
  62                 }
  63         }
  64         if (is_uncompressed) is_bamout = 1;
  65         if (is_header_only) is_header = 1;
  66         if (is_bamout) strcat(out_mode, "b");
  67         else {
  68                 if (of_type == BAM_OFHEX) strcat(out_mode, "x");
  69                 else if (of_type == BAM_OFSTR) strcat(out_mode, "X");
  70         }
  71         if (is_bamin) strcat(in_mode, "b");
  72         if (is_header) strcat(out_mode, "h");
  73         if (is_uncompressed) strcat(out_mode, "u");
  74         if (argc == optind) return usage();
  75
  76         // open file handlers
  77         if ((in = samopen(argv[optind], in_mode, fn_list)) == 0) {
  78                 fprintf(stderr, "[main_samview] fail to open file for reading.\n");
  79                 goto view_end;
  80         }
  81         if ((out = samopen(fn_out? fn_out : "-", out_mode, in->header)) == 0) {
  82                 fprintf(stderr, "[main_samview] fail to open file for writing.\n");
  83                 goto view_end;
  84         }
  85         if (is_header_only) goto view_end; // no need to print alignments
  86
  87         if (argc == optind + 1) { // convert/print the entire file
  88                 bam1_t *b = bam_init1();
  89                 int r;
  90                 while ((r = samread(in, b)) >= 0) // read one alignment from `in'
  91                         if (!__g_skip_aln(in->header, b))
  92                                 samwrite(out, b); // write the alignment to `out'
  93                 if (r < -1) fprintf(stderr, "[main_samview] truncated file.\n");
  94                 bam_destroy1(b);
  95         } else { // retrieve alignments in specified regions
  96                 int i;
  97                 bam_index_t *idx = 0;
  98                 if (is_bamin) idx = bam_index_load(argv[optind]); // load BAM index
  99                 if (idx == 0) { // index is unavailable
 100                         fprintf(stderr, "[main_samview] random alignment retrieval only works for indexed BAM files.\n");
 101                         ret = 1;
 102                         goto view_end;
 103                 }
 104                 for (i = optind + 1; i < argc; ++i) {
 105                         int tid, beg, end;
 106                         bam_parse_region(in->header, argv[i], &tid, &beg, &end); // parse a region in the format like `chr2:100-200'
 107                         if (tid < 0) { // reference name is not found
 108                                 fprintf(stderr, "[main_samview] fail to get the reference name. Continue anyway.\n");
 109                                 continue;
 110                         }
 111                         bam_fetch(in->x.bam, idx, tid, beg, end, out, view_func); // fetch alignments
 112                 }
 113                 bam_index_destroy(idx); // destroy the BAM index
 114         }
 115
 116 view_end:
 117         // close files, free and return
 118         free(fn_list); free(fn_out); free(g_library); free(g_rg);
 119         samclose(in);
 120         samclose(out);
 121         return ret;
 122 }
 123
 124 static int usage()
 125 {
 126         fprintf(stderr, "\n");
 127         fprintf(stderr, "Usage:   samtools view [options] <in.bam>|<in.sam> [region1 [...]]\n\n");
 128         fprintf(stderr, "Options: -b       output BAM\n");
 129         fprintf(stderr, "         -h       print header for the SAM output\n");
 130         fprintf(stderr, "         -H       print header only (no alignments)\n");
 131         fprintf(stderr, "         -S       input is SAM\n");
 132         fprintf(stderr, "         -u       uncompressed BAM output (force -b)\n");
 133         fprintf(stderr, "         -x       output FLAG in HEX (samtools-C specific)\n");
 134         fprintf(stderr, "         -X       output FLAG in stirng (samtools-C specific)\n");
 135         fprintf(stderr, "         -t FILE  list of reference names and lengths (force -S) [null]\n");
 136         fprintf(stderr, "         -o FILE  output file name [stdout]\n");
 137         fprintf(stderr, "         -f INT   required flag, 0 for unset [0]\n");
 138         fprintf(stderr, "         -F INT   filtering flag, 0 for unset [0]\n");
 139         fprintf(stderr, "         -q INT   minimum mapping quality [0]\n");
 140         fprintf(stderr, "         -l STR   only output reads in library STR [null]\n");
 141         fprintf(stderr, "         -r STR   only output reads in read group STR [null]\n");
 142         fprintf(stderr, "\n\
 143 Notes:\n\
 144 \n\
 145   1. By default, this command assumes the file on the command line is in\n\
 146      the BAM format and it prints the alignments in SAM. If `-t' is\n\
 147      applied, the input file is assumed to be in the SAM format. The\n\
 148      file supplied with `-t' is SPACE/TAB delimited with the first two\n\
 149      fields of each line consisting of the reference name and the\n\
 150      corresponding sequence length. The `.fai' file generated by `faidx'\n\
 151      can be used here. This file may be empty if reads are unaligned.\n\
 152 \n\
 153   2. SAM->BAM conversion: `samtools view -bt ref.fa.fai in.sam.gz'.\n\
 154 \n\
 155   3. BAM->SAM conversion: `samtools view in.bam'.\n\
 156 \n\
 157   4. A region should be presented in one of the following formats:\n\
 158      `chr1', `chr2:1,000' and `chr3:1000-2,000'. When a region is\n\
 159      specified, the input alignment file must be an indexed BAM file.\n\
 160 \n\
 161   5. Option `-u' is preferred over `-b' when the output is piped to\n\
 162      another samtools command.\n\
 163 \n");
 164         return 1;
 165 }
 166
 167 int main_import(int argc, char *argv[])
 168 {
 169         int argc2, ret;
 170         char **argv2;
 171         if (argc != 4) {
 172                 fprintf(stderr, "Usage: bamtk import <in.ref_list> <in.sam> <out.bam>\n");
 173                 return 1;
 174         }
 175         argc2 = 6;
 176         argv2 = calloc(6, sizeof(char*));
 177         argv2[0] = "import", argv2[1] = "-o", argv2[2] = argv[3], argv2[3] = "-bt", argv2[4] = argv[1], argv2[5] = argv[2];
 178         ret = main_samview(argc2, argv2);
 179         free(argv2);
 180         return ret;
 181 }