Changes

From Genome Analysis Wiki
Jump to: navigation, search

LibStatGen: VCF

27 bytes added, 16:47, 25 July 2012
no edit summary
</source>
==== Subsetting Reading a Subset of Samples ====
To select only a subset of samples to keep, when opening the file also specify the name of the file containing the names of the samples to keep and the delimiter separating the sample names (default is a new line, '\n').
<source lang="cpp">
The <code>VcfSubsetSamples* subset</code> parameter is a pointer to the subset of samples that you want to include when counting the number of alternate alleles. If all samples that are read/kept are to be included, NULL should be passed in.
To specify See [[#Handling a Subset of Samples|Handling a Subset of Samples]] for how to use <code>VcfSubsetSamples</code> use the constructor:<source lang="cpp">void VcfSubsetSamples::init(const VcfHeader& header, bool include)</source>Pass in the header that was read from the VCF file. Set <code>include</code> to true if all samples should be included except any that are specified as excluded. Set <code>include</code> to false if all samples should be excluded except any that are specified as included. NOTE: the header is not modified to add/remove any samples. To mark a specific sample as excluded use:<source lang ="cpp">bool VcfSubsetSamples::addExcludeSample(const char* sampleName);</source>To mark a specific sample as included use:<source lang ="cpp">bool VcfSubsetSamples::addIncludeSample(const char* sampleName);</source>
Use the following method to remove the DiscardMinAltAlleleCount rule:
The <code>VcfSubsetSamples* subset</code> parameter is a pointer to the subset of samples that you want to include when counting the number of alleles. If all samples that are read/kept are to be included, NULL should be passed in.
To specify See [[#Handling a Subset of Samples|Handling a Subset of Samples]] for how to use <code>VcfSubsetSamples</code> use the constructor:<source lang="cpp">void VcfSubsetSamples::init(const VcfHeader& header, bool include)</source>Pass in the header that was read from the VCF file. Set <code>include</code> to true if all samples should be included except any that are specified as excluded. Set <code>include</code> to false if all samples should be excluded except any that are specified as included. NOTE: the header is not modified to add/remove any samples. To mark a specific sample as excluded use:<source lang ="cpp">bool VcfSubsetSamples::addExcludeSample(const char* sampleName);</source>To mark a specific sample as included use:<source lang ="cpp">bool VcfSubsetSamples::addIncludeSample(const char* sampleName);</source>
Use the following method to remove the DiscardMinMinorAlleleCount rule:
=== VcfRecordFilter ===
<code>VcfRecords</code> contain the data from the <code>INFO</code> field in a <code>VcfRecordFilter</code> object.
 
 
== Handling a Subset of Samples ==
 
When reading a file if you only want to process/keep a subset of samples, use [[#Reading a Subset of Samples|Reading a Subset of Samples]]. When that method is used, only the specified samples are stored. Any further processing will only be on those samples.
 
Some methods allow the user to specify a subset of samples to operate on. The subset specified when reading the VCF file, if any, is automatically applied since only those samples were stored. If a different/additional subset needs to be applied for other processing, you can use the <code>VcfSubsetSamples</code> class.
 
To setup a VcfSubsetSamples object, pass the already set VCF header to:
<source lang="cpp">
void VcfSubsetSamples::init(const VcfHeader& header, bool include)
</source>
Set the <code>include</code> parameter to:
* true if all samples should be included except any that are specified as excluded.
* false if all samples should be excluded except any that are specified as included.
 
NOTE: the header is not modified to add/remove any samples.
 
To mark a specific sample as excluded use:
<source lang="cpp">
bool VcfSubsetSamples::addExcludeSample(const char* sampleName);
</source>
To mark a specific sample as included use:
<source lang="cpp">
bool VcfSubsetSamples::addIncludeSample(const char* sampleName);
</source>

Navigation menu