HomozgosityMapper pedigree Login

Documentation

AutozygosityMapper is primarily aimed at VCF files, we recommend using HomozygosityMapper to analyse SNP arrays.

FAQs: Click here to read the frequently asked questions

AutozygosityMapper can be used free of charge (even for commercial purposes) and without a login.

This software is being further developed. You might occasionally discover new features that haven't yet made it into the manual. We apologise in advance if this causes confusion, but we want to make new features available as soon as possible.

While we could import a variety of SNP chips and provide the infrastructure to upload genotypes created with them, we could not test all of them - simple due to the lack of the genotypes. If you cannot upload your data or want other species or chips to be included, please send an email to dominik.seelow (at) charite.de.

Contents

Create a profile

You can use AutozygosityMapper without a personal account. However, with a user profile, access to your data will be facilitated and you can also change the access restrictions (only you, everyone, selected co-operation partners) at any time.

It is not possible to choose a user name that is already in use, AutozygosityMapper will raise an error in such cases. You should always enter a valid e-mail address because we will inform you in advance when major changes to the website are planned or when we have to archive old projects due to disk space limitations.
If you forgot your password, you have the possibility to click on I forgot my credentials! next to the help button on the login page. Afterwards you can enter the e-mail address which you registered your account with, so that your credentials can be sent to you.

After you have created a password, you will be automatically logged in with these data. If you return to AutozygosityMapper, please click on the login link on the homepage and enter your credentials.

Select a species

If you want to upload, analyse, or view genotypes of any non-human species or want to switch to another species, simply click on the correct species in the panel on the right top of the homepage.

So far, AutozygosityMapper covers the following species:

Humans Cattle Humans Humans
Humans
Homo sapiens


Cattle
Bos taurus
Dogs
Canis lupus
Horses
Equus ferus caballus
Humans Humans Humans  
Mice
Mus musculus
Rats
Rattus norvegicus
Sheep
Ovis aries

Please see contributions for copy rights.

Upload genotypes 

Genotypes from VCF files and the following chips can be imported:

Humans
  • Affymetrix 10K Xba142
  • Affymetrix 50K Hind240
  • Affymetrix 50K Xba240
  • Affymetrix 250K_Nsp
  • Affymetrix 250K_Sty
  • Affymetrix GenomeWideSNP5
  • Affymetrix GenomeWideSNP6
  • Affymetrix Axiom Hu (CEU)
  • Affymetrix Axiom ASI
  • Illumina HumanOmni1-Quad
  • Illumina HumanOmni1S
  • Illumina HumanOmni2.5
  • Illumina (all SNP chips with dbSNP ID)
Cattle
  • Affymetrix Bovine 25KPanel
  • Affymetrix TG Bovine 10KPanel
  • Illumina BovineSNP50
Dogs
  • Affymetrix V1 platinum
  • Affymetrix V2 platinum
  • Affymetrix V2 full
Horses
  • Illumina EquineSNP50
Mice
  • Affymetrix Mouse diversity
  • Affymetrix: TG Mouse 5KPanel
Rats
  • Affymetrix Rat Mapping 10K
  • Affymetrix Rat Mapping 5K
Sheep
  • Illumina OvineSNP50

If your specied or chip is not listed here, please send us an email.

To import the genotypes, specify a new project name under new project name.

You can also decide whether or not you want to make the project public (checkbox access restriction).
If you are logged in with a personal account, this setting can be changed at any time and you can also share your data with selected collaborators (via the 'grant access to your data' link on the homepage). If you upload your data as guest, you will receive special URLs for access-restricted data; the data will be invisible to anyone else. Without the URL, you will not be able to access your data again. Also, it is not possible to use URL-protected genotypes in GeneDistiller to rank candidate genes by their homozyosity scores.
Please note that data uploaded as guest will be deleted after two month to save disk space. We hence recommend to create an account, especially if you want to keep your data private. Personal accounts are completely free.

After choosing a project name, you have to select wether you want to upload a 'VCF' or a genotyping chip (genotypes from VCF file or SNP chip). After choosing one of the options, more fields will appear. In case you choose the VCF file option, you have the possibility to set a minimum coverage and point to the genotype file (genotype file) to eventually submit the data. In case you choose the SNP chip option, you can select the respective SNP chip from a drop down menu (choose SNP chip) and afterwards point to the genotype file (genotype file) to eventually submit the data.

SNP genotype files must be tabular with the samples as columns and the SNPs as rows, they can (or rather should) also be zipped or gzipped. Lines starting with the number sign (#) will be ignored. Sample files to demonstrate the allowed formats can be found here. The genotypes must be written in standard Affymetrix or Illumina notation, i.e. (NoCall, AA, AB, BB or -1, 0, 1, 2 for Affymetrix and --, AA, AB, BB for Illumina, respectively).

AutozygosityMapper is primarily aimed at VCF files, we recommend using HomozygosityMapper instead.

VCF genotype files must combine the genotypes of all samples in one file (see below). A short description and a sample VCF file can be obtained from the file formats page.
All variations from the RefSeq in your file will be used. You can also set a coverage threshold (minimum coverage). Genotypes with a coverage below this value will be treated as no calls. Please note that the DP flag must be included in the FORMAT string (not only in INFO!), unless you set the minimum coverage value in the upload interface to 0. Without the DP flag in FORMAT it is impossible to exclude genotypes with a low coverage because the DP information in INFO aggegrates the coverage over all samples!


If you want to combine different VCF files, you should create a joint file from the original BAM files. Using bcftools, this can be achieved by

bcftools mpileup -Ou -a DP -f reference.fa FILE1.bam FILE2.bam | bcftools call -mv -Ov -o VCFFILE.vcf
# reference genome: reference.fa
# output VCF file: VCFFILE.vcf
Please read the bcftools to find the appropriate settings for your data.
GATK offers a similar option.

The data import may take seconds or even half an hour, depending on the size of the file, the upload speed and the working load of our server.

When the upload has been finished, you can proceed to the next step.

Mixing of arrays with different markers per sample is possible. However, AutozygosityMapper only considers markers that were genotyped for a sample. That means, that if you mix different arrays you will automatically obtain lower homozygosity scores for samples with fewer genotypes.
We believe that any other solution (using block length in megabases instead of SNP numbers, treating non-typed markers as unknown genotypes, or use only markers available in all samples) would merely complicate the application and make it less performant in more realistic scenarios. If, however, you are in such a situation, please drop us an e-mail. At attempt to solve this might be worthwile, challenging and exciting... :-)

Analyse your data

After the genotypes were imported, you can start the homozygosity mapping. First, you must select the project you want to analyse (drop-down menu project) and provide a new name for the analysis (analysis name). You can specify further details under analysis description which will be displayed together with the analyses' names to indicate specific models etc. which might be too complex to include them in the name.

Under cases and controls, you can specify the samples that should be regarded as cases or controls, respectively. Cases are, of course, obligatory. Please note that sample IDs must be written exactly as in the genotype file; AutozygosityMapper will, however, complain, if it cannot find a sample.

If your cases are from a single family or if you are absolutely sure that there is no genetic heterogeneity among the samples you plan to analyse as cases, you can tick the require autozgysotiy box: The case samples must share the same homozygous genotype. In the text field exclude homozygous stretches in controls >= below, you can define a threshold for the length of homozygous blocks in controls. Whenever these exceed this value, the region will be excluded. The suggested values (printed next to the input field) are relatively high to reduce the risk of false negatives.

Another parameter to be set is the maximum block length (limit block length). If this field is left empty, the standard setting for chips will be used (6 mbp). If you don't want to limit the block length, specify a negative value. While the default settings are suitable for most analyses, after a visual inspection of the results you may decide to re-analyse your data according to the degree of homozygous blocks in your data. A small value might be appropriate if you want to find a founder mutation in a very large sample consisting of individuals from non-related families.

The next parameter to define would be the minimum number of variants. If you leave the field empty, the default value 10 will be used in case of vcf files and 4 in case of snp files.

Only count blocks longer than x . This parameter is an experimental way to fine-tune the block length settings. This is a lower limit of the block length; i.e. only homozygous stretches longer than n bases are be included in the score. This switch is helpful when you expect a large degree of genetic heterozygosity and hence only a small proportion of cases to be homozygous at the same location. This might be the case if you study many single cases from consanguineous families which might not share the same disaese locus.

The analysis might take several minutes to complete.

The analysis is described in more detail here.

Use autozygosity required only when analysing patients from the same family. Patients from different families will share the same homozygous region when there is no locus heterogeneity but not the same genotypes!

Query genotypes  

This interface allows you to select one of your own analyses (coloured blue) to inspect homozygosity scores and genotypes. In addition, analyses of other researchers made public (green) or accessible for you (black) will be listed. Analyses are ordered by project name and analysis name. Your own analyses appear on top of the list.

Simply click on the correct analysis to inspect genome-wide homozygosity.

If you are interested in the homozygosity around some candidate genes, use the GeneDistiller link on the right of each item. Please note that GeneDistiller will be opened without any further information and will complain unless you enter your candidate genes or a genomic region of interest.

Homozygosity score view

Here, the homozygosity scores are plotted against the physical position. The interface can either display the whole genome, a single chromosome or a selected region on a single chromosome. Interesting regions are indicated by red bars.
This view becomes more interesting when 'sporadic cases' with a suspected inbreeding background but without close consanguinity and hence very short homozygous stretches are studied.
Below the bar chart, you have the possibility to define a specfic region for which the genotypes will be displayed. Furthermore, all scores above 60% of the maximum are listed (sorted by their score) and direct links to these regions are provided. On top of this table, 'broad' regions are displayed - in these, smaller decreases of the score within a homozygous region are neglected. At the bottom of the table, 'narrow' regions with sharp limits follow. If you expect some degree of heterozygosity, you should consider the 'broad' regions.

Below the scores, two links to GeneDistiller are shown, either for the broad or the narrow regions.

Below the regions, links to GeneDistiller and export options are displayed:

Genome-wide homozygosity

genome-wide homozygosity

In the whole genome view, clicking on a chromosome will zoom on this chromosome.

Chromosomal homozygosity

After clicking on a chromosome, the view zooms into this chromosome. Now only the interesting regions located within the selected region (here: the chromosome) will be displayes as links.

chromosomal homozygosity

Chromosomal homozygosity - zoom in

After clicking on the edges of the region the user want to study in details, a pop-up will appear and offer links to further zoom in or to see the underlying genotypes.

chomosomal homozygosity - zoom in

Genotypes view

The genotype view depicts the single genotypes of all samples marked as cases or controls. The genotypes are indicated as coloured boxes; where blue codes for heterozygous, grey for unknown and red for homozygous genotypes. Different shades of red are used, longer homozygous stretches will be drawn in a 'deeper' red than single homozygous markers. Genotypes homozygous for another allele are marked with a black diagonal bar.

The homozygous region found by AutozygosityMapper is shown as a rectangle, it's limits can be shifted to other markers by clicking on these.

chomosomal homozygosity - zoom in

After the region has been defined, you can go ahead by clicking on the GeneDistiller button to find candidate genes (see below) within the region or export only the genotypes within the homozygous or autozygous regions as VCF. You can also directly analyse them in MutationDistiller.

Detailed inspection is possible with the Genotypes table link.

Genotypes table

This table shows you the genotypes within the homozygous region. InDels are indicated as X here, but the real alleles are included in the downloadable VCF. The number behind the genotype indicates the length of the homozygous stretch in the individual at this position.

We use different shades of red for the different homozygous alleles - this shows that the region in which Sample1 and Sample2 have the same homozygous genotypes is actually much smaller than their homozygous region. A search for autozygosity instead of homozygosity would have identified this smaller region.

chomosomal homozygosity - zoom in

Finding a candidate gene

AutozygosityMapper integrates with GeneDistiller. When clicking the GeneDistiller button, GeneDistiller's query interface will open with the correct region filled in. Clicking on submit in this interface will list all genes within the region; for a description how GeneDistiller can be used to focus on genes of interest take a look at it's manual:
http://www.genedistiller.org/manual.html

When GeneDistiller is queried from AutozygosityMapper, each gene will carry another link, 'AutozygosityMapper', which will open the genotypes view and indicate the position of the selected genes within the genotypes. Bookmarking GeneDistiller's settings (on the bottom of it's results list) will maintain the hyperlinks to the respective homozygosity mapping.

Export homozygous regions in VCF format

Below the table with the regions you find the possibility to export these regions as a vcf file, which will be generated and downloaded after a click on the respective button. You can choose between the narrow and broad regions.

Find disease mutations via MutationDistiller

Below the export option, you find a link to MutationDistiller, a tool for the further analysis of the found regions and identification of pathogenic DNA variants as well as known disease mutations. There, you can upload the exported VCF file with the respective regions and add additional information (if present) for the analysis. A tutorial can be found here.

This analysis results in an overview of genes with potential disease mutations (see pictures below). Further below on the analysis results page, you can find additional information on the gene-linked diseases.

chomosomal homozygosity - zoom in

chomosomal homozygosity - zoom in

chomosomal homozygosity - zoom in

Grant access to your data

You can use this interface to fine-tune access to your data. It will display a table with all of your projects as rows and all user logins as columns. For each user and project, you can select whether he or she shall be allowed to query your data. You can further grant the right to perform new analyses on your data to collaborators (the project and the analyses will remain under your control though). At the end of each row, you have the option to grant (or revoke) query permissions to the public.

Click on SetPermissions when you're done.

Delete your data

Use this interface to delete single analyses within a project or complete projects.

All of your projects and analyses will be listed. Checking a project/analysis will mark it for deletion; if you delete a project, all analyses performed with that dataset will be deleted as well.

Please note that deleted data will be lost forever.

Implementation / technical details 

AutozygosityMapper is based on a PostgreSQL database, all interfaces were written in Perl. The database schema and further details can be found in the technical documentation.

The application was developed using various flavours of Mozilla Firefox. It was further tested with Google Chrome and Microsoft Edge.

Benchmarks

We include some benchmarks to demonstrate the speed of AutozygosityMapper. Two examples were uploaded and analysed under normal usage of the webserver and the RDBMS. Please keep in mind that a heavy load on the server and especially a slow network connection may decrease the application's speed significantly.

Example Genotypes SNPs/variants Samples (cases/controls)   Time
(min:s)
SNP tutorial genotypes Affymetrix 50K
Hind 240
(download)
56,936 8 (5/3)
upload & homozygosity detection 1:08
        analysis 0:06
      display of genome-wide homozygosity 0:01
 
VCF tutorial genotypes WES VCF
(download)
139,733 4 (2/2) upload & homozygosity detection
0:21
        analysis (homozygosity) 0:06
        analysis (autozygosity) 0:06
        display of genome-wide homozygosity 0:01
VCF WES genotypes very large WGS VCF
(download)
17,740,640 4 (2/2) upload & homozygosity detection
58:42
        analysis (homozygosity) 5:56
        analysis (autozygosity) 5:45
        display of genome-wide homozygosity 0:32
Stand-alone version

In addition to the web-based version, a stand-alone application exists. This program does not make use of a database and interfaces were created with Perl/Tk. While it offers speed gains for small chips (up to 50,000 SNPs), the performance decreases with the number of markers being studied. This version is not supported anymore but we will gladly share the source code. Please send us an e-mail if you are interested.

Cite AutozygosityMapper 

Team

Dominik Seelow Berliner Institut für Gesundheitsforschung | Charité, Berlin, Germany
Robin Steinhaus Berliner Institut für Gesundheitsforschung | Charité, Berlin, Germany
Melanie Vogel Freie Universität Berlin, Berlin, Germany
Björn Fischer-Zirnsak Charité, Berlin, Germany
Felix Boschann Charité, Berlin, Germany

Contact

Email: dominik.seelow(at)charite.de

If you discovered bugs or have suggestion, please write us an email to our ticketing system.

FAQs

Why is this software still using genome build 37?
Because it is still the most-widely used genome version in medical genetics. Besides, the SNP array annotation files refer to 37. We will certainly offer build 38 in the future.

Do I have access to my HomozygosityMapper projects on AutozygosityMapper?
No.

Why do my results differ between HomozygosityMapper and AutozygosityMapper?
HM uses the number of consecutive homozygous genotypes to calculate the length of homozygous segments, AM uses their physical length. The first approach was perfect for SNP arrays with evenly-distributed markers but it performs worse with WES genotypes where only protein-coding genes are covered. A large number of homozygous variants within one gene gives a very high score in HM, even if the homozygous stretch is relatively short.

Will my HomozygosityMapper projects remain?
Yes, as long as you created them while logged in (please delete your projects as soon as possible!).

Do I have to create a new account?
We took over all HomozygosityMapper accounts by Dec 15th 2020. Accounts that were created after that date are either valid for HomozygosityMapper OR AutozygosityMapper.

Why am I not able to find the allele frequencies anymore?
For now, they are not required for the search for homozygous regions. Furthermore, they would require more storage space and especially a higher run time.

Can I archive projects in HomozygosityMapper and restore them in AutozygosityMapper?
No, because the structure of the data base has changed considerably.

Why can't I further zoom in on a single chromosome? Why can't I change the limits of a homozygous region?
Sounds as if JavaScript was not enabled. With Mozilla Firefox, select Tools -> Options -> Content and check the 'Enable JavaScript' button.

I forgot my login and/or my password. What can I do?
Please recover your credentials via the "I forgot my credentials!" link on the login page. Your data will be sent to you via the e-mail address you enter here, in case this is the address you registered your account with.

I am using a chip that is not listed, how can I upload my genotypes?
So far, AutozygosityMapper only supports the most common chips manufactured by Affymetrix and Illumina. If you want to import genotypes derived by other chips (or means), you can either bring your genotype file in the format as used by Affymetrix or Illumina and select a chip containing all your markers or write us an e-mail. The integration of completely new chips and file formats might take some time, though.

I made a terrible mistake and deleted my project. Is there any way to restore it?
Well, yes, at least there might be one. If you are lucky, the data is included in one of our backups. Please write an e-mail to us and specify the exact name of the project. We will then see what we can do.

Is the data within AutozygosityMapper stored forever?
Hm. Certainly not forever but at least we do not plan to include an automatic time-out after which your data will be deleted. We might, for disk space reasons, decide to archive 'old projects'. However, we will inform the respective project's owners in advance.

I have created an account but I cannot log in. Why?
Please ensure that you allowed this site to set cookies in your browser. This is the default setting in all current browsers - if you deactivated cookies you could change the setting to 'ask' instead of 'block' or add an exception for this website.

How is this homozgyosity score calculated?
AM calculates the length of the homozygous block (in SNPs) at each position/marker for each sample. The values of the 'cases' are then added to get the 'homozygosity score' for a position. It is, however, actually a bit more complex: The maximum length for each block (that will be added to the final score) is per default set to some limits (depending on the user-defined 'limit block length' or default value) to reduce the effect of very long blocks in one or few samples. That means, that a very long block (say 100 mbp) is 'reduced' to the 'limit block length' setting (say 6 mbp).
For case-control studies or 'distant consanguinity', only blocks longer than a user-defined value 'only count blocks longer than' are regarded to reduce the influence of non-informative segments.
And, of course, in the case of 'genetic homogeneity', regions are excluded when the same homozygous haplotype is found in any controls.
The analysis is described in more detail in the technical documentation.

Why are your sample VCF so much smaller than my own VCFs?
We stripped them of all data not required to use AutozygosityMapper.

Contributions

Species pictures

Cow: LadyofHats
Dog: Mathieu19
Humans: L. Salzman Sagan, C. Sagan, F. Drake / NASA
Horse: Wilfredor
Mouse: The Tango! Desktop Project
Rat: Martin Krzywinsk
Sheep: Michał Pecyna