Quick start guide on URL image receiver data acquisition program

Requirements

This DAQ needs to be installed on a computer (linux or windows) located in the same network as the camera you want to control. (The camera must be accessible e.g. in your browser.)

Install the conda env

  • Make sure you have miniforge or similar installed

  • Create the asi-core conda environment (location of the asi-core repository may be different on your computer):

    conda env create -f C:\git\sfpt_meteo_nowcasting\asi-core\environment.yml

    Using a conda environment is not strictly needed. Feel free to install the package in another environment with python 3.10 installed.

  • Activate the conda environment

    conda activate asi_core

  • Install the asi-core package

    pip install -e C:\git\sfpt_meteo_nowcasting\asi-core

Set your local configuration

  • Create config file for your data acquisition task based on this template

    C:\git\sfpt_meteo_nowcasting\asi-core\asi_core\daq\asi_daq_cfgs\template.yaml

  • Set the URL of the camera in your local network e.g.

    url_cam: 'http://10.21.202.145'

  • Set the path to which you want to store your results:

    storage_path: 'C:/data/test_daq/server_folder'

  • Set the working directory of the DAQ program. In this folder log files will be stored

    daq_working_dir: 'C:/data/test_daq/asi-core/log_folder'

  • Set the coordinates of the camera e.g.

    location: {'lat': 37.09415129, 'lon': -2.35478069, 'alt': 500}

Run the DAQ

  • Activate the conda environment

    conda activate asi_core

  • Run the daq providing your config file as argument, e.g.:

    python C:\git\sfpt_meteo_nowcasting\asi-core\asi_core\daq\url_image_receiver.py -c "C:\git\sfpt_meteo_nowcasting\asi-core\asi_core\daq\asi_daq_cfgs\Cloud_Cam_Metas.yaml"

  • You can adapt the following script to do the job

    C:\git\sfpt_meteo_nowcasting\asi-core\asi_core\daq\run_all_GUIs.bat

Further settings

The DAQ uses a number of default settings which can be changed if needed when initializing a Receiver instance. Comment in parameters in the Process section of the config file if needed. The default parameters are suited for Q26.