An observation log record links a sampling log to the FOSS DS2500 provision, recording how samples were prepared and stored before scanning. One observation log is created per sampling-log/preparation combination. Individual spectral scans reference these log records.

Prerequisites

Notebook cell

In load_ai4sh_spectral_data.ipynb, the Manage FOSS DS2500 observation log cell runs:

job_file = 'import_data/DS2500_spectra/job_DS2500_observation_log.json'

structured_process_D, scheme_params_D = Initiate_process(notebook_path, scheme_file, job_file)

if structured_process_D is not None:
    Run_process(structured_process_D, scheme_params_D)

Job file

Path: ./ai4sh/import_data/DS2500_spectra/job_DS2500_observation_log.json

{
  "process": {
    "job_folder": "import_data/DS2500_spectra/observation_log",
    "process_sub_folder": "process",
    "pilot_file": "xspatula_add_observation_log_pilot.txt"
  }
}

Pilot file

Path: ./ai4sh/import_data/DS2500_spectra/observation_log/xspatula_add_observation_log_pilot.txt

ai4sh_dk_foulum_2024@foss ds2500 l_ds2_observation_log.json
ai4sh_dk_foulum_2024@foss ds2500 l_ilmx_observation_log.json
ai4sh_fi_jokioinen_2024@foss ds2500 l_ds2_observation_log.json
...

14 entries — one per field site / preparation combination.

Process file example

Path: ./ai4sh/import_data/DS2500_spectra/observation_log/process/ai4sh_dk_foulum_2024@foss ds2500 l_ds2_observation_log.json

{
  "process": [
    {
      "process": "manage_observation_log",
      "parameters": {
        "sampling_log_id__sampling_log_name": "ai4sh_dk_foulum_2024",
        "provision_id__provision_name": "foss ds2500 l",
        "name": "ai4sh_dk_foulum_2024@foss ds2500 l_ds2",
        "contact_name": "thomas gumbricht",
        "contact_email": "thomas.gumbricht@natgeo.su.se",
        "preparation_id__preparation_name": "ds2",
        "preservation_id__preservation_name": "ds2",
        "storage_id__storage_name": "amb",
        "laboratory": 1
      }
    }
  ]
}

Parameters

Parameter Description
sampling_log_id__sampling_log_name FK lookup: parent sampling log
provision_id__provision_name FK lookup: foss ds2500 l
name Observation log name — pattern: <sampling_log>@<provision_short>_<preparation>
contact_name Responsible person
contact_email Contact email
preparation_id__preparation_name FK lookup: sample preparation (e.g. ds2 = dried and sieved 2 mm)
preservation_id__preservation_name FK lookup: preservation method
storage_id__storage_name FK lookup: storage condition (e.g. amb = ambient)
laboratory Integer flag — 1 for laboratory-based observations

Next step

Proceed to Manage FOSS DS2500 observation.

Updated: