File: Replicon.java

package info (click to toggle)
rockhopper 2.0.3%2Bdfsg2-3
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 33,136 kB
  • sloc: java: 10,831; sh: 31; xml: 29; makefile: 14
file content (298 lines) | stat: -rw-r----- 9,039 bytes parent folder | download | duplicates (2)
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
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
/*
 * Copyright 2013 Brian Tjaden
 *
 * This file is part of Rockhopper.
 *
 * Rockhopper is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * any later version.
 *
 * Rockhopper 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 General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * (in the file gpl.txt) along with Rockhopper.  
 * If not, see <http://www.gnu.org/licenses/>.
 */

import java.util.Scanner;
import java.io.File;
import java.io.FileNotFoundException;

public class Replicon {

    /********************************************
     **********   Instance Variables   **********
     ********************************************/

    private String name;      // Name of replicon (first line of FASTA file)
    private String sequence;  // Original DNA sequence with '$' appended
    private int length;       // Length of sequence
    private int[] rotations;  // Burrows-Wheeler matrix of cyclic rotations
    private String BWT;       // Borrows-Wheeler transform of original sequence

    private int[] C;          // Number of chars lexicographically less than...
    private int[][] occ;      // Number of occurrences of char up to row...



    /**************************************
     **********   Constructors   **********
     **************************************/

    public Replicon(String fastaFile) {
	this.sequence = readInFastaFile(fastaFile);
	this.sequence = this.sequence.toUpperCase();
	this.sequence = this.sequence.replace('U', 'T');
	this.sequence = replaceAmbiguousCharacters();
	this.sequence = this.sequence + "$";
	this.length = sequence.length();
	this.rotations = rotations();
	this.BWT = getTransform();

	precomputeCharacterInfo();  // Populate "C" and "occ" instance variables
    }



    /*************************************************
     **********   Public Instance Methods   **********
     *************************************************/

    // Return a row of the cyclic rotations matrix.
    public String getStringInRotationsMatrix(int row) {
	return sequence.substring(rotations[row]) + sequence.substring(0, rotations[row]);
    }

    // Reverse the BWT transform
    public String unpermute() {
	StringBuilder sb = new StringBuilder();
	int r = 0;
	while (BWT.charAt(r) != '$') {
	    sb.append(BWT.charAt(r));
	    r = stepLeft(r);
	}
	return sb.reverse().toString();
    }

    /**
     * Returns the name of the genome sequence (FASTA header line).
     */
    public String getName() {
	return this.name;
    }

    /**
     * Returns the DNA sequence of this Replicon.
     */
    public String getSequence() {
	return this.sequence;
    }

    /**
     * Returns the length of the genome sequence (plus 1).
     */
    public int getLength() {
	return this.length;
    }

    /**
     * Returns number of characters lexographically less than x.
     */
    public int getC(int x) {
	return this.C[x];
    }

    /**
     * Returns number of occurrences of character x up to row y.
     */
    public int getOcc(int x, int y) {
	return this.occ[x][y];
    }

    /**
     * Returns index in Burrows-Wheeler rotations matrix at row x.
     */
    public int getRotations(int x) {
	return this.rotations[x];
    }



    /**************************************************
     **********   Private Instance Methods   **********
     **************************************************/

    // Read in sequence from from file.
    private String readInFastaFile(String fastaFile) {
	try {
	    Scanner reader = new Scanner(new File(fastaFile));
	    StringBuilder sb = new StringBuilder();

	    // Handle header line
	    if (reader.hasNextLine()) {
		String line = reader.nextLine();
		if (line.startsWith(">")) {  // Header line
		    this.name = line.substring(1).trim();
		} else {  // Not header line
		    sb.append(line);
		}
	    }

	    // Read in file
	    while (reader.hasNextLine()) {
		sb.append(reader.nextLine());
	    }

	    reader.close();
	    return sb.toString();
	} catch (FileNotFoundException e) {
	    Peregrine.output("\nError - could not open file " + fastaFile + "\n\n");
	    System.exit(0);
	}
	return "";
    }

    // Replace any non-nucleotide character with '^'.
    // We use '^' because its ASCII value is greater than A,C,G,T
    private String replaceAmbiguousCharacters() {
	StringBuilder sb = new StringBuilder(this.sequence);
	for (int i=0; i<sb.length(); i++) {
	    if ((sb.charAt(i) != 'A') && (sb.charAt(i) != 'C') &&
		(sb.charAt(i) != 'G') && (sb.charAt(i) != 'T'))
		sb.setCharAt(i, '^');
	}
	return sb.toString();
    }

    // Compute the Burrows-Wheeler matrix of cyclic rotations.
    // Rather than return a matrix, we return an array of integers
    // where each value in the array is an index into the sequence.
    // So a "row" of the matrix corresponds to the cyclic sequence
    // beginnning at the specified index. All rows of the matrix
    // have length equal to the length of the sequence.
    private int[] rotations() {
	int[] indices= new int[this.length];
	for (int i=0; i<length; i++) indices[i] = i;
	quicksort(indices, 0, length-1);
	return indices;
    }

    // Compute the Burrows-Wheeler transform from the "rotations"
    // matrix, i.e., the last column of the matrix.
    private String getTransform() {
	StringBuilder sb = new StringBuilder();
	for (int i=0; i<length; i++) {
	    sb.append(sequence.charAt((rotations[i]-1+length) % length));;
	}
	return sb.toString();
    }

    // Precompute information about how often each character occurs in BWT
    private void precomputeCharacterInfo() {

	// Populate instance variable "C"
	this.C = new int[6];  // All characters in DNA sequence have
	                        // ASCII value less than 123.
	for (int i=0; i<length; i++) C[Index.charToInt(BWT.charAt(i))] += 1;

	// Cumulative
	int[] temp = new int[6];
	temp[0] = C[0] + C[5];  // Number of characters <= 'A'
	temp[5] = C[5];         // Number of characters <= '$'
	for (int i=1; i<5; i++) temp[i] = C[i] + temp[i-1];

	// Strictly less than
	for (int i=0; i<6; i++) C[i] = temp[i] - C[i];

	// Populate instance variable "occ"
	this.occ = new int[5][length+1];
	for (int i=0; i<length; i++) {
	    for (int j=0; j<5; j++) {
		occ[j][i+1] = occ[j][i];
	    }
	    int index = Index.charToInt(BWT.charAt(i));
	    if ((index >= 0) && (index < 5)) occ[index][i+1]++;
	}
    }

    // Helper method for Burrows-Wheeler transform.
    // Taken from appendix of Bowtie article.
    private int stepLeft(int r) {
	int index = Index.charToInt(BWT.charAt(r));
	return C[index] + occ[index][r];
    }

    // We quicksort the array. But we don't sort the values at
    // each array index, since each value is an index 
    // corresponding to a String. We sort the Strings specified
    // by each array index.
    private void quicksort(int[] a, int p, int r) {
	if (p < r) {
	    int q = partition(a, p, r);
	    quicksort(a, p, q-1);
	    quicksort(a, q+1, r);
	}
    }

    // Quicksort helper method
    private int partition(int[] a, int p, int r) {
	int x = Index.rand.nextInt(r - p + 1) + p;
	swap(a, x, r);
	x = a[r];
	int i = p-1;
	for (int j=p; j<r; j++) {
	    if (lessThanOrEqualTo(a[j], x)) {  // a[j] <= x
		i++;
		swap(a, i, j);
	    }
	}
	swap(a, i+1, r);
	return i+1;
    }

    // Quicksort partition helper method
    private void swap(int a[], int i, int j) {
	int temp = a[i];
	a[i] = a[j];
	a[j] = temp;
    }

    // Given two indices in "sequence", determine whether the
    // cyclic String corresponding to the first index is less 
    // than or equal to the cyclic String corresponding to
    // the second index.
    private boolean lessThanOrEqualTo(int i, int j) {
	for (int z=0; z<length; z++) {
	    if (sequence.charAt((i+z)%length) < sequence.charAt((j+z)%length))
		return true;
	    if (sequence.charAt((i+z)%length) > sequence.charAt((j+z)%length))
		return false;

	}
	return true;  // We have equality of the two Strings
    }



    /*************************************
     **********   Main Method   **********
     *************************************/

    public static void main(String[] args) {

        if (args.length < 1) {
            System.err.println("\nUSAGE: java Replicon <index.fna>" + "\n");
            System.err.println("Replicon takes a sequence file (such as a FASTA genome) to be indexed and it computes the Burrows-Wheeler transformed index. If run from the command line, it simply outputs the size of the index to STDOUT. The Replicon class is meant to be instantiated from another application. \n");
            System.exit(0);
        }

	Replicon index = new Replicon(args[0]);
	System.out.println("Size of index is:\t" + index.BWT.length());
    }

}