SAFR : Solution Guide - Attendance Log

This document describes how to set up SAFR to be used to record attendance to an event thru a registration station.  This is a managed of self-serviced attendance process.  In the managed case, one or more staff register people as they arrive to an event,  This can be done with a handheld device or from a registration desk with a laptop and a webcam.  The staff asks the person to pose and the camera is pointed at the person's face until recognition occurs.  This process would be similar to scanning a badge.  Once recognized, registration is complete.  The record is stored to the events database where it can be reported on later.  

In the self-registration mode, a kiosk is set up and new arrivals will go to the kiosk, click the screen to wake it up if necessary and wait for their name to be displayed.  If recognition occurs, then a welcome message is displayed.  If recognition does not occur, then user is prompted to click on the purple oval around their face to register themselves.

Registrants can be added in two different ways

  1. Images along with other information such as name and ID number can be pre-loaded thru a process described below.
  2. Unrecognized persons can be added at the time of check-in directly thru the registration device
    1. If managed by registration staff, If the person is not recognized, the staff can ask their name and enter the information on the screen.
    2. For self-registration kiosk, person can be prompted to enter name if not present in database

 

Setup On Machine
  1. Download and install git from "https://git-scm.com/downloads"
  2. Go to http://safr.real.com/download
    1. Sign in with your SAFR Account
    2. Download and install "SAFR Edge for Windows" "Standard Edition"
  3. Configure SAFRActions to write CSV file
    1. Make sure SAFRActions application is closed
    2. Copy 'SAFRActions.config" to following location (overwrite existing file)
      • C:\ProgramData\RealNetworks\SAFR\ares\config\
    3. Copy 'write_log.bat' to following location:
      • C:\Program Files\RealNetworks\SAFR\ares\scrips\
    4. Start SAFRActions from the Start Menu
    5. Enter username and password in the SAFRActions application if needed
       
  4. Setup SAFR App on each phone
    1. Mode should be "Recognize" (at top of screen).
    2. Switch to Front or Back camera as needed using icon in lower left
    3. Open Preferences by clicking on the gear icon
      1. On Android this is in upper left. On iPhone its in lower left
    4. Go to Account Tab and set following:
      1. Make sure the Environment is set to "SAFR Cloud" 
      2. username (user identifier)
      3. password (user password)
      4. User source (camera or phone name such as "Note9")
      5. user Site (location such as "Center")
    5. Go to the Events tab and set the following:
      1. Check "Report Events" checkbox
You can use the phone to either recognize people who have already been added or to add new people.  Below describes each.

Attachments:

  • SAFRActions.config
  • write_log.bat.zip
  •  

    Recognizing People
    1. Open the SAFR App
    2. Switch the camera to the rear facing camera so its pointing at people in front of you
    3. Hold the phone up to someone so the face takes up 1/2 the screen or more
    4. An oval will be drawn around the person's face
      • A grey circle means that image is not clear enough or not facing the camera
        • Move closer to the person or ask them to look directly in the camera until color changes
      • A purple circle means person is not recognized but can be added
      • A green circle means person is recognized (you should see the name below the oval unless a name was never added
    Adding People
    1. Following directions above.  If oval is purple perform the following
    2. Click inside the purple oval
    3. Wait for a prompt to type name
    4. Type in the name and if desired the location in format of "First Last (stop name)"
      1. e.g. "Jane Doe (Main Street)
    5. Submit the dialog.  
      1. You should see the oval change to green and name show up belo face
      2. If not, try again or take a picture and add later
    Importing Photos
    1. Create new directory inside F:\SAFR with pictures to import (e.g. Pictures2)
    2. Create a CSV file inside F:\SAFR with the list of new people to import from Pictures2 directory (e.g. Pictures2.csv).  
      1. Columns of the file should be:  first_name,last_name,ID,imagefile,stopname,dummycolumn
        1. Note: dummycolumn is an extra column needed to prevent error due to bug in script.  This column is ignored and can be any string.
    3. Run “Git bash”
    4. Inside the Git Bash window type the following commands:
      1. cd /f/SAFR
      2. sh import.sh -u <username> -p <password> -d <pictures directory> -f <people file> > <results file>
      3. e.g. :   sh import.sh -u youraccount -p ******* -d Pictures2 -f Pictures2.csv > Pictures2Results.txt
        1. The output will be written to the file "Pictures2Results.txt" so you can review if needed.

    Reporting

    The CSV log file contains one row for reach recognition.  This may include duplicates.  To report attendance the report should group by person by day to identify which people attended which days.  This can be done easily in Excel as demonstrated by attached 

    attendance_report_example.xlsx

    To import new data to the report do the following:

    The process for updating the report with new data is as follows:

    1. Copy new CSV file from SAFR Actions logs directory to local machine
      (warning) Do not open the CSV file from the server because Excel will block new writes toe the file while it is open. 
    2. Open new CSV file, click anywhere in the table of data and press Control-A (this selects all rows) then copy the selection
    3. Open events_log_report_examlpe XLS 
    4. Select cell A1 of the "timelog" tab
    5. Paste the data copied from the CSV file in Step 2
    6. Go to the report tab.  Right click the pivot table in Columns A-C and choose "Refresh".
    7. If needed, extend the formulas in columns E and F to produce results for all pivot table rows.

     

    Troubleshooting
    If you are not getting events, try some of the following:
    1. Make sure you checked "Reprot Events" in the SAFR Application
      1. In Preferences in the "Events" tab, the very top checkbox "Report Events" must be selected
    2. Make sure there are no errors in the log file
      1. Open Log in following location in a text editor like Notepad or Wordpad
        1. C:\ProgramData\RealNetworks\SAFR\ares\logs\ares.log
      2. Scroll to the bottom and look for last few lines:
        1. --- RECONFIGURED at 2019-06-01 18:24:49
          NETWORK ERROR: 2019-06-01 18:24:49 0 Socket closed
          Listening for events...
          1. The last line should be "Listening for Events"
          2. Its ok to see "NETWORK ERROR"

    Attachments:

    SAFRActionsUserPwd.png (image/png)
    attendance_report_example.xlsx (application/vnd.openxmlformats-officedocument.spreadsheetml.sheet)