Skip to content
Klaus Rettinghaus edited this page Apr 27, 2018 · 15 revisions

CSV2CMI

About

CSV2CMI is a little program to transform a table of letters (given as .csv) into the CMI format. The CMI format is the underlying data format for the web service correspSearch which facilitates searching across diverse distributed letter repositories.

Usage

You have to name your columns as follows:

  • name of the sender: "sender"
  • name of the addressee: "addressee"
  • IDs of the named persons/organisations: "senderID" and "addresseeID"
  • the date, when the letter has been sent: "senderDate"

You may provide places as additional information:

  • where a letter has been sent: "senderPlace" (with the appropriate "senderPlaceID" as proper GeoNames URL)
  • where a letter has been received: "addresseePlace" (with the appropriate "addresseePlaceID" as proper GeoNames URL)

If your letters are printed across different editions, add an "edition" column and put in there the bibliographic records. Numbering of letters should be stated in a additional column named "key". Alternatively you may enter in this column a link to the edited letter on the web. If a date is put within brackets it sets @cert to "medium", for <persName>, <orgName>, and <placeName> alike @evidence is set.
By default only edited letters (i.e. letters with a given edition) are transferred to CMI output. If you want to convert your complete catalogue, use the -a option.

Check, that your table is using UTF8-encoding!

Metadata for the resulting file can be given in the configuaration file csv2cmi.ini.

Known limitations:

  • only a single date can be set
  • a config file must be present

System requirements

CSV2CMI should run out of the box an every system. If it doesn't, make sure Python3 is installed.

License

This program is available under The MIT License (MIT)

Clone this wiki locally