UCL WIKI

UCL Logo
Page tree
Skip to end of metadata
Go to start of metadata

This page is still under construction.

The mapping process can be less manual by using .txt files.Please send the files to Hayley Mills to load into Archivist. Once loaded you can then check the mappings. The format specifications are given at the end of the page, along with examples. Grid mappings and derived variable mappings must be completed using .txt files.

Archivist pages to view mappings

Note: you must be logged into Archivist to view the below pages.

A question list can be saved as a .txt from Archivist by navigating to the instrument view and then adding /cc_questions.txt to the web address e.g.https://archivist.closer.ac.uk/instruments/alspac_01_rat/cc_questions.txt

A question list with sequences can be saved as a .txt from Archivist by navigating to the instrument view and then adding /mapper.txt to the web address e.g.https://archivist.closer.ac.uk/instruments/alspac_01_rat/mapper.txt


Mappings (once applied) can be viewed in Archivist by navigating to either the instrument or dataset view using the following suffixes. Details of the formats for each can be found at the bottom of this page. 

Question to variable mappings add /qv.txt to the instrument web address e.g.https://archivist.closer.ac.uk/instruments/alspac_01_rat/qv.txt

Question to topic mappings add /tq.txt to the instrument web address e.g. https://archivist.closer.ac.uk/instruments/alspac_01_rat/tq.txt

Derived variable mappings add /dv.txt to the dataset web address e.g. https://closer-archivist.herokuapp.com/datasets/12/dv.txt

Variable to topic mappings add tv.tx to the dataset we address e.g. https://closer-archivist.herokuapp.com/datasets/12/tv.txt

Dataset and instrument views

Datasets > search and select the Name of the dataset.  Any mapping conflicts will appear in red.

The question-variable mappings can also be checked through Instruments > search and select the Prefix (or view) of the instrument. This will gives the questionnaire view with the variable names listed against them

Note: Variables can be mapped to grid references in the mapping.txt file, but currently these will only be displayed as mapped to the gird as a whole. See table for how to map to grid cells.

Format specifications

cc_questions.txt

Question list produced by Archivist.

  • ID
  • Text (Literal)

qv.txt

Mapping file which links questions and variables (listing all variables and derived variables).

  • Tab delimited
  • Must include all variables including derived variables
  • 2 columns:
    • qc
      • Question name
      • ‘0’ if mapped to nothing
      • ‘0’ if derived variable
      • [OPTIONAL] suffix grid cell coordinates in the format $X;Y. Please refer to the Grid coordinates table on the condition page for how to reference grid cells.
    • Variable name

tv.txt

Mapping file which links topics and variables.

  • Tab delimited
  • Used for applying level 1 and 2 topics to variables
  • Uses Colectica topic IDs
  • 2 columns:

 tq.txt

Mapping file which links topics and questions.

  • Tab delimited
  • Used for applying level 1 and 2 topics to variables
  • Uses Colectica topic IDs
  • 2 columns:

dv.txt

Mapping file which links derived variables to variables.

  • Tab delimited
  • 2 columns:
    • Derived variable name
    • Source variable name

Note: All the .txt mapping files detailed above will be available to view in Archivist v.10 (the current version can be found under Info).

  • No labels