contexere 0.3.1

Scientists and engineer create a multitude of digital artefacts during their daily work:

• experimental results,

• simulation results,

• literate programming notebooks analysing experiments and simulations

• statistical models,

• machine learning models,

• figures,

• tables, etc

In order to trace and track these multiple interconnected research artefacts, hierarchical naming schemes are a powerful tool to document the connection between research artefacts, find previous research outputs, and enable reproducible research [1].

The following naming scheme has evolved over several years to track research artefacts of all kinds.

The general scheme is: DSyymd[hMM]e[_x]__title

• DS: Project specific initials. Here, DS stands for Data Science.

• yy: [0-9][0-9] are the last two digits of the years in the 21st century. I won’t live beyond that. So, I do not care for following centuries.

• m: [o-z] these letters map to the respective months.

• d: [1-9,A-V] represent the 31 days of a month. Digits and upper-case characters have approximately the same height, such that this element gives a visual structure to the name, which divides the date from the daily counter.

• h: [a-x] these optional letters refer to the hours of the day

• MM: [0-5][0-9] are the minutes with 00 encoding the full hour

• e: [a-z]+ daily counter as lower-case letter enumerating the respective database or dataset. The 28th dataset would start with be enumerated as aa.

• x: Optional attribute being the last significant characters of the dataset, from which DSyymde is derived.

• title: Readable name of the respective data set with whitespaces being replaced by underscores.

• The first dataset created on Friday 01.01.2021 would be named DS21o1a.

• The second dataset created on the same day would be named DS21o1b.

• An analysis (e.g. Jupyter notebook) of the first data set started after the second data set had been created would be named DS21o1c_a. Exported figures of this analysis should be named DS21o1c_a__[plottype].[filetype].

• An analysis of data set DS21o1b started on 2nd January should be named DS21o2a_1b.

• An meta analysis of DS21o1c_a and DS21o2a_1b started on 11th February should be named DS21pBa_o1c_2a.

git clone git@github.com:kempa-liehr/contexere.git
cd contexere
pip install .

name
DS24xUa

name myProject
myProject24xUa

name --time
DS24xUi54