Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The mapping process can be less manual by using .txt files.The format specifications are given at the end of the page, along with examples. Currently the .txt files, mapper.txt and qvmapping.txt are available to view in Archivist, as detailed below.

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 /mappercc_questions.txt to the web address e.g.https://archivist.closer.ac.uk/instruments/alspac_01_rat/mappercc_questions.txt.The question to variable mapping.txt

Mappings (once applied) can be viewed in Archivist by navigating to either the instrument view and then adding 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 /mapping.txt to the instrument web address e.g.https://archivist.closer.ac.uk/instruments/alspac_01_rat/mapping.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

The following steps can be used to upload mappings via the .txt files. Note you must notify Hayley Mills or Will Poynter when you are carrying out these mappings using this method, so the appropriate server can be turned on first.

...

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.

Format specifications:

...

cc_questions.txt

Question and sequence list produced by Archivist.

  • ID (qc or URN)
  • Type (“Question” or “Sequence”)
  • Grid limits or “-“ for null ([Y,X])
  • Parent (URN)
  • Text (Literal or Sequence name)

...

mapping.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.

...