@gmod/cram 4.0.4 → 4.0.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +53 -51
- package/dist/cram-bundle.js +1 -1
- package/dist/cramFile/codecs/_base.d.ts +1 -1
- package/dist/cramFile/codecs/byteArrayLength.js +3 -2
- package/dist/cramFile/codecs/byteArrayLength.js.map +1 -1
- package/dist/cramFile/codecs/external.d.ts +1 -1
- package/dist/cramFile/codecs/external.js +1 -4
- package/dist/cramFile/codecs/external.js.map +1 -1
- package/dist/cramFile/container/index.d.ts +16 -34
- package/dist/cramFile/container/index.js +5 -20
- package/dist/cramFile/container/index.js.map +1 -1
- package/dist/cramFile/file.d.ts +8 -6
- package/dist/cramFile/file.js +37 -73
- package/dist/cramFile/file.js.map +1 -1
- package/dist/cramFile/record.js.map +1 -1
- package/dist/cramFile/sectionParsers.js +3 -2
- package/dist/cramFile/sectionParsers.js.map +1 -1
- package/dist/cramFile/slice/decodeRecord.d.ts +2 -2
- package/dist/cramFile/slice/decodeRecord.js +7 -4
- package/dist/cramFile/slice/decodeRecord.js.map +1 -1
- package/dist/cramFile/slice/index.js +14 -16
- package/dist/cramFile/slice/index.js.map +1 -1
- package/dist/cramFile/util.d.ts +5 -0
- package/dist/cramFile/util.js +75 -51
- package/dist/cramFile/util.js.map +1 -1
- package/esm/cramFile/codecs/_base.d.ts +1 -1
- package/esm/cramFile/codecs/byteArrayLength.js +3 -2
- package/esm/cramFile/codecs/byteArrayLength.js.map +1 -1
- package/esm/cramFile/codecs/external.d.ts +1 -1
- package/esm/cramFile/codecs/external.js +2 -5
- package/esm/cramFile/codecs/external.js.map +1 -1
- package/esm/cramFile/container/index.d.ts +16 -34
- package/esm/cramFile/container/index.js +5 -20
- package/esm/cramFile/container/index.js.map +1 -1
- package/esm/cramFile/file.d.ts +8 -6
- package/esm/cramFile/file.js +37 -73
- package/esm/cramFile/file.js.map +1 -1
- package/esm/cramFile/record.js.map +1 -1
- package/esm/cramFile/sectionParsers.js +3 -2
- package/esm/cramFile/sectionParsers.js.map +1 -1
- package/esm/cramFile/slice/decodeRecord.d.ts +2 -2
- package/esm/cramFile/slice/decodeRecord.js +7 -4
- package/esm/cramFile/slice/decodeRecord.js.map +1 -1
- package/esm/cramFile/slice/index.js +14 -16
- package/esm/cramFile/slice/index.js.map +1 -1
- package/esm/cramFile/util.d.ts +5 -0
- package/esm/cramFile/util.js +74 -51
- package/esm/cramFile/util.js.map +1 -1
- package/package.json +3 -6
- package/src/cramFile/codecs/_base.ts +1 -1
- package/src/cramFile/codecs/byteArrayLength.ts +4 -12
- package/src/cramFile/codecs/external.ts +3 -7
- package/src/cramFile/container/index.ts +5 -24
- package/src/cramFile/file.ts +41 -77
- package/src/cramFile/record.ts +1 -1
- package/src/cramFile/sectionParsers.ts +5 -2
- package/src/cramFile/slice/decodeRecord.ts +26 -23
- package/src/cramFile/slice/index.ts +25 -31
- package/src/cramFile/util.ts +107 -73
- package/errors.js +0 -27
package/README.md
CHANGED
|
@@ -142,6 +142,7 @@ directory for usage with script tag
|
|
|
142
142
|
##### Table of Contents
|
|
143
143
|
|
|
144
144
|
- [CramRecord](#cramrecord)
|
|
145
|
+
- [Parameters](#parameters)
|
|
145
146
|
- [isPaired](#ispaired)
|
|
146
147
|
- [isProperlyPaired](#isproperlypaired)
|
|
147
148
|
- [isSegmentUnmapped](#issegmentunmapped)
|
|
@@ -161,12 +162,34 @@ directory for usage with script tag
|
|
|
161
162
|
- [getReadBases](#getreadbases)
|
|
162
163
|
- [getPairOrientation](#getpairorientation)
|
|
163
164
|
- [addReferenceSequence](#addreferencesequence)
|
|
164
|
-
- [Parameters](#parameters)
|
|
165
|
+
- [Parameters](#parameters-1)
|
|
165
166
|
|
|
166
167
|
#### CramRecord
|
|
167
168
|
|
|
168
169
|
Class of each CRAM record returned by this API.
|
|
169
170
|
|
|
171
|
+
##### Parameters
|
|
172
|
+
|
|
173
|
+
- `$0` **any** 
|
|
174
|
+
|
|
175
|
+
- `$0.flags`  
|
|
176
|
+
- `$0.cramFlags`  
|
|
177
|
+
- `$0.readLength`  
|
|
178
|
+
- `$0.mappingQuality`  
|
|
179
|
+
- `$0.lengthOnRef`  
|
|
180
|
+
- `$0.qualityScores`  
|
|
181
|
+
- `$0.mateRecordNumber`  
|
|
182
|
+
- `$0.readBases`  
|
|
183
|
+
- `$0.readFeatures`  
|
|
184
|
+
- `$0.mateToUse`  
|
|
185
|
+
- `$0.readGroupId`  
|
|
186
|
+
- `$0.readName`  
|
|
187
|
+
- `$0.sequenceId`  
|
|
188
|
+
- `$0.uniqueId`  
|
|
189
|
+
- `$0.templateSize`  
|
|
190
|
+
- `$0.alignmentStart`  
|
|
191
|
+
- `$0.tags`  
|
|
192
|
+
|
|
170
193
|
##### isPaired
|
|
171
194
|
|
|
172
195
|
Returns
|
|
@@ -282,23 +305,23 @@ of paired orientatin
|
|
|
282
305
|
##### addReferenceSequence
|
|
283
306
|
|
|
284
307
|
Annotates this feature with the given reference sequence basepair information.
|
|
285
|
-
This will add a `sub` and a `ref` item to base
|
|
308
|
+
This will add a `sub` and a `ref` item to base substitution read features given
|
|
286
309
|
the actual substituted and reference base pairs, and will make the
|
|
287
310
|
`getReadSequence()` method work.
|
|
288
311
|
|
|
289
312
|
###### Parameters
|
|
290
313
|
|
|
291
314
|
- `refRegion`
|
|
292
|
-
**[object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)
|
|
315
|
+
**[object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** 
|
|
293
316
|
|
|
294
317
|
- `refRegion.start`
|
|
295
|
-
**[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)
|
|
318
|
+
**[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)** 
|
|
296
319
|
- `refRegion.end`
|
|
297
|
-
**[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)
|
|
320
|
+
**[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)** 
|
|
298
321
|
- `refRegion.seq`
|
|
299
|
-
**[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)
|
|
322
|
+
**[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** 
|
|
300
323
|
|
|
301
|
-
- `compressionScheme` **CramContainerCompressionScheme
|
|
324
|
+
- `compressionScheme` **CramContainerCompressionScheme** 
|
|
302
325
|
|
|
303
326
|
Returns
|
|
304
327
|
**[undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined)**
|
|
@@ -336,9 +359,9 @@ that show insertions, deletions, substitutions, etc.
|
|
|
336
359
|
##### Parameters
|
|
337
360
|
|
|
338
361
|
- `args`
|
|
339
|
-
**[object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)
|
|
362
|
+
**[object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** 
|
|
340
363
|
|
|
341
|
-
- `args.cram` **CramFile
|
|
364
|
+
- `args.cram` **CramFile** 
|
|
342
365
|
- `args.index` **Index-like** object that supports
|
|
343
366
|
getEntriesForRange(seqId,start,end) -> Promise\[Array\[index entries]]
|
|
344
367
|
- `args.cacheSize`
|
|
@@ -363,14 +386,20 @@ that show insertions, deletions, substitutions, etc.
|
|
|
363
386
|
- `end`
|
|
364
387
|
**[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)**
|
|
365
388
|
end of the range of interest. 1-based closed coordinates.
|
|
366
|
-
- `opts`
|
|
389
|
+
- `opts` **{viewAsPairs:
|
|
390
|
+
[boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)?,
|
|
391
|
+
pairAcrossChr:
|
|
392
|
+
[boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)?,
|
|
393
|
+
maxInsertSize:
|
|
394
|
+
[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)?}**
|
|
395
|
+
(optional, default `{}`)
|
|
367
396
|
|
|
368
397
|
#### hasDataForReferenceSequence
|
|
369
398
|
|
|
370
399
|
##### Parameters
|
|
371
400
|
|
|
372
401
|
- `seqId`
|
|
373
|
-
**[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)
|
|
402
|
+
**[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)** 
|
|
374
403
|
|
|
375
404
|
Returns
|
|
376
405
|
**[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)**
|
|
@@ -383,42 +412,15 @@ ID
|
|
|
383
412
|
|
|
384
413
|
##### Table of Contents
|
|
385
414
|
|
|
386
|
-
- [constructor](#constructor)
|
|
387
|
-
- [Parameters](#parameters)
|
|
388
415
|
- [containerCount](#containercount)
|
|
389
416
|
|
|
390
|
-
#### constructor
|
|
391
|
-
|
|
392
|
-
##### Parameters
|
|
393
|
-
|
|
394
|
-
- `args`
|
|
395
|
-
**[object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)**
|
|
396
|
-
|
|
397
|
-
- `args.filehandle`
|
|
398
|
-
**[object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)?**
|
|
399
|
-
a filehandle that implements the stat() and read() methods of the Node
|
|
400
|
-
filehandle API <https://nodejs.org/api/fs.html#fs_class_filehandle>
|
|
401
|
-
- `args.path`
|
|
402
|
-
**[object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)?**
|
|
403
|
-
path to the cram file
|
|
404
|
-
- `args.url`
|
|
405
|
-
**[object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)?**
|
|
406
|
-
url for the cram file. also supports file:// urls for local files
|
|
407
|
-
- `args.seqFetch`
|
|
408
|
-
**[function](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function)?**
|
|
409
|
-
a function with signature `(seqId, startCoordinate, endCoordinate)` that
|
|
410
|
-
returns a promise for a string of sequence bases
|
|
411
|
-
- `args.cacheSize`
|
|
412
|
-
**[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)?**
|
|
413
|
-
optional maximum number of CRAM records to cache. default 20,000
|
|
414
|
-
- `args.checkSequenceMD5`
|
|
415
|
-
**[boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)?**
|
|
416
|
-
default true. if false, disables verifying the MD5 checksum of the reference
|
|
417
|
-
sequence underlying a slice. In some applications, this check can cause an
|
|
418
|
-
inconvenient amount (many megabases) of sequences to be fetched.
|
|
419
|
-
|
|
420
417
|
#### containerCount
|
|
421
418
|
|
|
419
|
+
Returns
|
|
420
|
+
**[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<([number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)
|
|
421
|
+
|
|
|
422
|
+
[undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))>** 
|
|
423
|
+
|
|
422
424
|
### CraiIndex
|
|
423
425
|
|
|
424
426
|
<!-- Generated by documentation.js. Update this documentation by updating the source code. -->
|
|
@@ -437,20 +439,20 @@ ID
|
|
|
437
439
|
##### Parameters
|
|
438
440
|
|
|
439
441
|
- `args`
|
|
440
|
-
**[object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)
|
|
442
|
+
**[object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** 
|
|
441
443
|
|
|
442
444
|
- `args.path`
|
|
443
|
-
**[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)
|
|
445
|
+
**[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?** 
|
|
444
446
|
- `args.url`
|
|
445
|
-
**[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)
|
|
446
|
-
- `args.filehandle` **FileHandle
|
|
447
|
+
**[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?** 
|
|
448
|
+
- `args.filehandle` **FileHandle?** 
|
|
447
449
|
|
|
448
450
|
#### hasDataForReferenceSequence
|
|
449
451
|
|
|
450
452
|
##### Parameters
|
|
451
453
|
|
|
452
454
|
- `seqId`
|
|
453
|
-
**[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)
|
|
455
|
+
**[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)** 
|
|
454
456
|
|
|
455
457
|
Returns
|
|
456
458
|
**[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)**
|
|
@@ -464,11 +466,11 @@ fetch index entries for the given range
|
|
|
464
466
|
##### Parameters
|
|
465
467
|
|
|
466
468
|
- `seqId`
|
|
467
|
-
**[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)
|
|
469
|
+
**[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)** 
|
|
468
470
|
- `queryStart`
|
|
469
|
-
**[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)
|
|
471
|
+
**[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)** 
|
|
470
472
|
- `queryEnd`
|
|
471
|
-
**[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)
|
|
473
|
+
**[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)** 
|
|
472
474
|
|
|
473
475
|
Returns
|
|
474
476
|
**[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)**
|