Utilities and Kinship Information for Research with the NLSY

Utilities and kinship information for behavior genetics and developmental research using the National Longitudinal Survey of Youth (NLSY; < http://www.bls.gov/nls/>).

GitHub Travis-CI AppVeyor Wercker Coveralls Codecov
Master Travis-CI Build Status Build status wercker status Coverage Status codecov.io
Dev Travis-CI Build Status Build status wercker status Coverage Status codecov.io
Ubuntu 12.04 LTS Windows Server 2012 Docker Travis Tests Wercker Tests

Utilities and kinship information for behavior genetics and developmental research using the National Longitudinal Survey of Youth (NLSY)


CRAN Version Rate Zenodo
Latest CRAN_Status_Badge CRANPace DOI
Latest CRAN version CRAN Downloads Independently-hosted Archive

The release version of NlsyLinks can be installed from CRAN.


The latest development version of NlsyLinks can be installed from GitHub after installing the devtools package.


Locations for Help and Development

This repository contains the code used in the NlsyLinks R package. For additional information about the package and using it in NLSY research, please see http://liveoak.github.io/NlsyLinks/

We now use this GitHub repository as our primary way of managing, tracking, and build-checking versions of the source code. We're no longer using our R-Forge site to check builds. The stable releases (intended for most researchers) is available on the package's CRAN site.

The help forums remain on the package's R-Forge.

Thanks to Funders

The current work on the NLSY Kinship links has been supported by NIH Grant R01-HD065865 (Joe Rodgers, PI).


Version 2.0.5 (2016-03-17)


  • Small updates to meet new testthat version.

Version 2.0.1 (2015-08-16)


  • SurveyDate datset contains survey details for each subject, for each year.
  • Small updates to meet newer CRAN guidelines.

Version 1.4005 (2015-01-15)


  • Small updates to vignettes and documentation.
  • Small updates to meet newer CRAN guidelines about title & description format.
  • Checked with R Tools 3.2.

Version 1.300 (2013-11-21)

New Features:

  • A more complete version of the Gen1 links are included. 95% of all Gen1 Housemates have been linked.


  • R now has missing values for Gen1 pairs if the 1979 roster (eg, R00001.51) doesn't indicate they're the same generation. If this value is desirable for your research, their R values are still available in RFull.
  • The naming scheme for the Links79Pair and Links79PairExpanded datasets are more consistent across variables. For variables that are measured separately for both subjects (eg, Gender), the subjects' variable name will have an _S1 or _S2 appended to it. For instance, the variables LastSurvey_S1 and LastSurvey_S2 correspond to the last surveys completed by the pair's first and second subject, respectively.
  • Similarly, the functions CreatePairLinksDoubleEntered and CreatePairLinksSingleEntered now by default append _S1 and _S2, instead of _1 and _2. However this can be modified using the subject1Qualifier and subject2Qualifier parameters.
  • Added function ReadCsvNlsy79Gen1()
  • Updated reference manual, ACE vignette, and FAQ.

Version 1.200 (2012-12-18)


  • Renamed R to RFull. RFull contains all the R values we have. R excludes R values in Gen1Housemates if they're 0, .375, or .75. The associated relationships (ie, Gen2Cousins and AuntNieces) become null for R, but not for RFull.

Version 1.017 (2012-11-29)


  • Removed code that assigned all unassigned siblings to .375. This doesn't make sense for Gen1, and was mostly an internal experiment (and wasn't released on CRAN).

Version 1.015 (2012-11-10)


  • Added outcome variables for Gen1. Renamed some outcome variables for Gen2.

Version 1.014 (2012-11-09)


  • Based on geocode variables, five Gen1 ambiguous twin was demoted to R=0 (two were R=.5; three were R=NULL).

Version 1.013 (2012-11-08)


  • Rebuilt For R2.15.2 with with RTools216.exe.

Version 1.012 (2012-10-11)


  • Small documentation updates

Version 1.011 (2012-10-11)


  • Gen1 Links are more thorough (but still in a beta state)
  • Gen1 and Gen2 information uses the NLSY 2010 survey wave (released this Spring 2012)

Version 1.010 (2012-10-11)

  • Refreshing after development interrupt to make sure everything builds and tests correctly

Version 1.007 (2012-06-08)


  • Added material to appendices of the NlsyAce vignette.
  • Removed 'stringr' package from Depends list. It's no longer used creating lavaan syntax.

Version 1.004 (2012-06-07)

New Features:

  • Added ParentChild links.
  • Added Gen1 links (using only Explicit items). There will be much more work to these relationship in the next few months.
  • Added Gen2Cousins & AuntNieces. These will change as the Gen1 links are filled out with implicit information.

Version 1.003 (2012-05-21)


  • Additional Documentation.

Version 1.001 (2012-05-04)


  • Started a FAQ (as a vignette).

Version 1.0 (2012-04-27)


  • Additional documentation and unit tests.
  • Changed R-Forge development status from "Beta" to "Production/Stable"

Version 0.29 (2012-04-22)


  • Modified some function signatures to be make package more consistent.
  • Additional lavaan example in ACE vignette.

Version 0.26 (2012-04-20)

New Features:

  • The new function 'AceLavaanGroup' uses the 'lavaan' package to estimate a multigroup SEM ACE model.

Version 0.24 (2012-04-16)

New Features:

  • The S4 class 'AceEstimate' is returned by the 'Ace' function.
  • Methods & functions associated with the AceEstimate class.
  • SubjectDetails79 dataset for Gen2.
  • ReadCsvNlsy79 function.
  • Validation functions: (a) OutComeDataset
  • Column Utilities: (a) VerifyColumnExists, (c) RenameNlsyColumn

Version 0.19 (2012-03-10)

New Features:

  • NLS Investigator vignette
  • ACE vignette
  • Generalized AceUnivariate function that wraps DeFriesFulkerMethod1 and DeFriesFulkerMethod3.
  • ExtraOutcomes79 dataset
  • Links79PairExpanded dataset
  • Validation functions: (a) OutcomeDataset, (b) PairLinks, (c) PairLinksAreSymmetric
  • Create functions for (a) SpatialNeighbours, (b) PairLinks, (c) SubjectTag

Version 0.10 (2012-01-16)

  • Initial submission to CRAN
  • Contains Nlsy79 Gen2 sibling links

GitHub Commits and Releases

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.


2.0.6 by Will Beasley, 4 years ago

http://liveoak.github.io/NlsyLinks, https://github.com/LiveOak/NlsyLinks, https://r-forge.r-project.org/projects/nlsylinks

Report a bug at https://github.com/LiveOak/NlsyLinks/issues

Browse source code at https://github.com/cran/NlsyLinks

Authors: Will Beasley , Joe Rodgers , David Bard , Michael Hunter , S. Mason Garrison , and Kelly Meredith

Documentation:   PDF Manual  

GPL license

Imports lavaan, methods

Depends on stats

Suggests devtools, ggplot2, knitr, plyr, scales, testit, testthat, xtable

See at CRAN