OneMap is a software tool designed for constructing genetic maps in experimental crosses, including full-sib, recombinant inbred lines (RILs), F2, and backcross populations. It was initially developed by Gabriel R. A. Margarido, Marcelo Mollinari, and A. Augusto F. Garcia, with later contributions from Rodrigo R. Amadeu, Cristiane H. Taniguti, and Getúlio C. Ferreira.
The software has been available on CRAN since 2007 (OneMap on CRAN) and has undergone several updates, adding new features and optimization up to version 3.2.0 in 2024. Future updates will focus solely on maintaining accessibility and functionality. New feature development and optimization efforts are now being directed toward the MAPpoly and MAPpoly2 packages.
MAPpoly is a more robust package designed for constructing linkage maps in polyploid species. Its optimized algorithms also provide improved efficiency for diploid species compared to OneMap. Therefore, we recommend using MAPpoly instead of OneMap in the following scenarios for diploid species:
- When working with only biallelic markers (e.g., SNPs).
- For outcrossing full-sib (F1), F2, or backcross populations.
- For datasets with a large number of markers (>5,000).
- For multi-population datasets (e.g., progeny from multiple parents; see MAPpoly2).
However, OneMap remains the best choice if you have:
- Populations derived from recombinant inbred lines (RILs).
- Datasets with multiallelic or dominant markers.
For guidance on best practices in building linkage maps while accounting for genotyping errors, please refer to this publication.
It is easy, just type (within R):
setRepositories(ind = 1:2)
install.packages("onemap", dependencies=TRUE)You also can use the console menus: Packages -> Install package(s). After clicking, a box will pop-up asking you to choose the CRAN mirror. Choose the location nearest to you. Then, another box will pop-up asking you to choose the package you want to install. Select onemap then click OK. The package will be automatically installed on your computer.
OneMap can also be installed by downloading the appropriate files
directly at the CRAN website and following the instructions given in section 6.3 Installing Packages of the
R Installation and Administration
manual.
Within R, you need to install and load the package devtools:
install.packages("devtools")
library(devtools)This will allow you to automatically build and install packages from GitHub. If you use Windows, first install Rtools. If you are facing problems with Rtools installation, try to do it by selecting the Run as Administrator option with the right mouse button. On a Mac, you will need Xcode (available on the App Store).
Then, to install OneMap from GitHub (this very repo):
install_github("Cristianetaniguti/onemap")You can read OneMap tutorials going to the vignettes of the installed package, or clicking below. Please, start with the overview, that will guide you through other chapters.
Margarido, G. R. A., Souza, A. P., &38; Garcia, A. A. F. (2007). OneMap: software for genetic mapping in outcrossing species. Hereditas, 144(3), 78–79. https://doi.org/10.1111/j.2007.0018-0661.02000.x
- If you are using OneMap versions > 2.0, please cite also:
Taniguti, C. H.; Taniguti, L. M.; Amadeu, R. R.; Lau, J.; de Siqueira Gesteira, G.; Oliveira, T. de P.; Ferreira, G. C.; Pereira, G. da S.; Byrne, D.; Mollinari, M.; Riera-Lizarazu, O.; Garcia, A. A. F. (2023) Developing best practices for genotyping-by-sequencing analysis in the construction of linkage maps. GigaScience, 12, giad092. https://doi.org/10.1093/gigascience/giad092
- If you used the HMM parallelization, please cite BatchMap paper too:
Schiffthaler, B., Bernhardsson, C., Ingvarsson, P. K., &; Street, N. R. (2017). BatchMap: A parallel implementation of the OneMap R package for fast computation of F1 linkage maps in outcrossing species. PLoS ONE, 12(12), 1–12. https://doi.org/10.1371/journal.pone.0189256