MORGAM logo

Data transfer format - DNA transfer request

  • Form: 40
  • Version: 2
  • Date: 2007-05-21

Valid HTML 4.01!
© National Institute for Health and Welfare and the MORGAM Project investigators
Last updated: 2009-10-09
For more information, please contact Ari Haukijärvi (firstname.lastname@thl.fi) or Kari Kuulasmaa (firstname.lastname@thl.fi)

The purpose of this transfer format is to provide an exact format for the MORGAM Data Centre (MDC) to transfer the identification of the subjects on whom DNA are expected to the MORGAM Participating Centre (MPC) and the DNA Extraction Laboratory in the National Institute for Health and Welfare Finland (THL). Data in the format specified here should be submitted by the MDC for every member of the MORGAM cohorts concerned, which has been selected for the genetic case-cohort substudy. The selection of these members is described in section "Instructions for MORGAM case and subcohort selections" and in "Instructions for DNA requests". The data should be sent via e-mail.

Contents



Format specification

NAME SPECIFICATION AND CODES FORMAT or Value
FORM Form number I2

|4|0|

VERSION Version of this form I1

|2|

LABTO MORGAM DNA Extraction Laboratory I3

|9|0|1|

MPCTO Identification of MORGAM Participating Centre I3

|_|_|_|

KEY1 Identification of individual in MORGAM study C12 |_|_||_|_||_|_||_|_|_|_|_|_|
KEY2 Sample identification C7 |_|_|_|_|_|_|_|
GENGROUP Genotyping group I1 |_|
DATE_REQ Date of the request for transfer of DNA (date ANSI)
YYYYMMDD (year month day)
C8 |_|_|_|_||_|_||_|_|


General Instructions

The item NAME on the document is a computer variable name used for the item by the MDC.

The item FORMAT specifies the format in which the value should be presented in the transfer data set:

FORMAT Type Format Example Comments
C Character C8 19991210 Used for dates, trailing zeroes are obligatory
C20 "B 17 E" Location of sample in a box, surrounded with double quotes (") if contains spaces. Free text, maximum 20 characters is allowed for this variable.
C3 -80 Storage temperature, includes leading '-' sign
F Float F5.2 13.1
2.18
Variable must include a decimal point (.). Leading and trailing zeroes are not obligatory.
I Integer I3 1
15
180
Leading zeroes are not obligatory

Instructions for making corrections to data that have already been sent to the MDC are given in Section Data communication between the Participating Centres and the MDC.

Please contact the MDC for instructions if you cannot provide information as specified in this document or if you have any problems with the interpretation of the coding for any specific items.


Specific instructions for each item

Follow these instructions carefully when creating a computer file for the data transfer from the MDC to MPC and MEL.

To the top of the form

FORM Form number I2

|4|0|

Number 40 indicates the "Data transfer format: DNA transfer request".

To the top of the form

VERSION Version of this form I1

|2|

Current version of this data transfer format. If the version number of the data transfer format which you are using is not "1", these instructions do not correspond to the format you are using. Version number changes if some major changes are introduced in the form, for example adding / deleting some variables.

To the top of the form

LABTO MORGAM DNA Extraction Laboratory I3

|9|0|1|

Enter appropriate code of MORGAM DNA Extraction Laboratory from the list of MORGAM centres for DNA transfer

To the top of the form

MPCTO Identification of MORGAM Participating Centre I3

|_|_|_|

From the list of MORGAM centres for DNA transfer select appropriate code of the MORGAM Participating centre for which DNA transfer request will be sent.

To the top of the form

KEY1 Identification of individual in MORGAM study:
CENTRE (2 char)
RUNIT (2 char)
COHORT (2 char)
SERIAL (6 char)
C12

|_|_||_|_||_|_||_|_|_|_|_|_|

This is a primary key, identifying individual in MORGAM study. Enter value of Centre code as characters 1-2, value of Reporting Unit code as characters 3-4, value of Cohort code as characters 5-6 and value of Serial number as characters 7-12.

To the top of the form

KEY2 Sample identification C7

|_|_|_|_|_|_|_|

KEY2 is a primary key, identifying DNA sample in MORGAM. KEY2 does not include any of the components of KEY1 (identifying individual in MORGAM study). KEY2 sample identification code is generated in the MDC and it's relation with KEY1 is kept in the MDC. The labels used for transferring the DNA samples from the DNA storage unit in KTL to other MORGAM Genotyping Laboratories include only KEY2 codes.

To the top of the form

GENGROUP Genotyping group:
1 = subcohort member or case during the follow-up who was healthy at baseline
2 = baseline case who is not in the subcohort
I1 |_|

Item GENGROUP makes it possible for the laboratory to place the baseline cases for a separate plate that can be genotyped later than the rest of the case-cohort set.

DATE_REQ Date of the request for transfer of DNA (date ANSI)
YYYYMMDD (year month day)
C8 |_|_|_|_||_|_||_|_|

Enter here the date when requests for DNA transfers were sent to MEL and MPC. Format is yyyymmdd (date ANSI, 8 characters, year day month).


Data transfer Instructions

The data should be prepared in ASCII comma-delimited format using semicolon (;) as delimiter, with the names of the variables in the first row. If the value of a variable contains text with delimiter used inside the text then the value should be surrounded by double quotes ("). A dot (.) shold be used as a decimal point.

To simplify the tracing of data transfers between the MPC and the MDC, the files should be named as follows:

MPCXX_YYYYMMDD_N.CSV, where:

To avoid possible errors in variable naming use the first row from the example below containing variable names. Example of Form 40 ASCII comma-delimited data file:

form;version;labto;mpcto;key1;key2;gengroup;date_req
40;1;901;20;200203123456;1234567;1;20041012
40;1;901;20;200203101234;1012345;1;20041012

The data files should be archived (ZIP) before sending them to the MDC. The archive names should be the same as the file names. MORGAM data Error checking program will be used to prepare data (will be available later). The data should be sent to MDC (Zygimantas Cepaitis (firstname.lastname@thl.fi)) as an attachment to an e-mail message. Please make sure to save a copy of the transferred files in the sending MPC or laboratory.

When the data are received in the MDC, an acknowledgement will be sent to the sender. Then the data will be checked for consistency and quality, and after any problems have been resolved, they will be entered into the MORGAM database.


Updates

Date Update
2007-09-24 Item GENGROUP was added.