Differences

This shows you the differences between two versions of the page.

--- en:praktikum:namenskonvention [2014/12/12 22:01] – msteinke
+++ en:praktikum:namenskonvention [2024/10/09 08:09] (current) – Adjusts name of laboratory computer rhainich
@@ Line 2: / Line 2: @@
 ====== Name conventions ======
-This article documents the conventions for filenames and directories in the astronomical laboratoury courses.
+This article documents the conventions for file names and directories on the computer (columba) used in the astronomical laboratory courses.
-=== praktikum ===
+/*
+=== Castor ===
-The user **praktikum** (ger.: laboratory courses) is the user name for all participants of the laboratory courses at the laboratory computer. The access possibilities for students are described in the article [[en:praktikum:zugang|Access to the laboratory computer]].
+The user **castor** is the user name for all participants of the laboratory courses at the laboratory computer. The access possibilities for students are described in the article [[en:praktikum:zugang|Access to the laboratory computer]].
-==== Semester directory ====
+*/
-In the root directory the subdirectories for the semesters can be found, named following this scheme ''ssXX'' or ''wsXX-XX'', where ''XX'' are the last two characters of the year(s), i.e.
+==== Work directory ====
-  ss12 oder ws12-13
-Within the account praktikum all participants of the laboratory courses have full writing rights. To avoid chaos, each group should create and use their own directory, preferably in the scheme ''groupX/gruppeX'', where X is the group number. Within that directory best create subdirectories for the different experiments. Note, N2 has its own [[en:praktikum:photometrie#vorbereitung_der_datenauswertung| naming scheme]]! The directory system should look like:
+In the Home directory you will find the directory ''data_reduction'', which is the default directory for the data reduction and all files that are relevant for the lab course.
-  praktikum's home directory
+/*
+In the Home directory the subdirectories for the semesters can be found, named following this scheme ''ssXX'' or ''wsXX-XX'', where ''XX'' are the last two characters of the year(s), i.e.
+  ss12 or ws12-13
+Within the account **castor** all participants of the laboratory courses have full writing rights. To avoid chaos, each group should create and use their own directory, preferably in the name scheme ''groupX'', where X is the group number. Within that directory best create subdirectories for the different experiments. Note, N2 has its own [[en:praktikum:photometrie#preparations_for_the_data_reduction| naming scheme]]! The directory system should look like:
+  castor's home directory
   --ss11
   ----group1
@@ Line 23: / Line 29: @@
   ----group3
-Old semester directories are kept in the directory ''cleanup''.
+Old semester directories are kept in the directory ''cleanup''.*/
 ==== Data and scripts ====
-The root directory hs further subdirectories:
+The root directory has further subdirectories:
-  * ''daten'' contains all observational data
+  * ''data'' contains all observational data
-  * ''skripte'' contains material (mostly scripts) that are needed/help for the laboratory courses. Do NOT save your data here, but copy the scripts to your group-directory. The observational data are for test purposes and demonstration of the script.
+  * ''scripts'' contains scripts and programs that are needed for the laboratory courses
+**Do NOT modify the scripts or the data in these directories, but copy all necessary files to your group directory.**
-=== Directory: daten ===
+=== Directory: data ===
-The data directory (daten) is subdivided in the scheme and directories are named ''YYYYMMDD'', e.g.
+In the data directory you will find further subdirectories that are named within the scheme ''YYYYMMDD'', e.g.
   20120815
 The data in this directory are then exposures of August 15, 2012.
-Copy your observational data to your group directory to make the data reduction there. **NOTE: Do NOT change the data in the directory ''daten''!** It serves as backup of the observations, i.e. to restore the rawdata in case the data reduction deleted parts of the files.
+Copy your observational data to your group directory to make the data reduction there. The files in the data directory serve as backup of the observations, i.e. to restore the raw data in case errors occur within the scope of the data reduction.
-The directory can contain special ''IDs'', attached to the name of the directory. The ID must be separated by an _ character, e.g.
+The directory can contain special ''labels'', attached to the name of the directory. The label must be separated by an underscore _, e.g.
   * _einsteinturm
   * _groupX
-The data for the observations S1 and S2 are taken at the Einsteintum, so the directory could be named ''YYYYMMDD_einsteinturm''. In case more than one group observed during a night, their respective data are stored in directories ''YYYYMMDD_groupX'', where X is their group number. Special cases may have their own IDs, which should be self-explanatory.
+The data for the observations S1 and S2 are taken at the Einsteintum, so the directory could be named ''YYYYMMDD_einsteinturm''. In case more than one group observed during a night, their respective data are stored in directories ''YYYYMMDD_groupX'', where X is their group number. Special cases may have their own labels, which should be self-explanatory.
-=== Directory: skripte ===
+=== Directory: scripts ===
-The directory ''skripte'' (scripts) contains scripts etc. needed for the laboratory courses. The directory contains subdirectories, named after the courses
+The scripts directory contains subdirectories, named after the id of the observations and should look like:
-  praktikum's home directory
+  castor's home directory
-  --skripte
+  --scripts
   ----s1s2
   ----n1
   ----n2
-Copy the scripts to your group directory to customize them as needed there. **NOTE: Do NOT change the scripts in the directory ''skripte''!**
+Copy the scripts to your group directory to customize them as needed there.
+/*
+==== Further directories ====
+All further directories are irrelevant for the laboratory courses.
-==== cleanup ====
+*/
-=== Directory: cleanup ===
-The directory ''cleanup'' contains the old semesters' directories. Further directories are irrelevant for the laboratory courses.
 [[en:praktikum:index|Overview: Laboratory Courses]]