$image_indexes[] = $image_index_arr;
    //--------------------------------------------------------------------------
    // create the image_comparisons array
    $image_comparison_arr = array_fill(0, $image_arr_len, 0);
    print_debug('image_comparison_arr');
    $image_comparison_arr_len = count($image_comparison_arr);
    print_debug('image_comparison_arr_len');
    assert($image_arr_len == $image_comparison_arr_len);
    $image_comparisons[] = $image_comparison_arr;
    //--------------------------------------------------------------------------
    if (!chdir('..')) {
        print_error('Could not chdir to ' . escapeshellarg('..') . '.');
    }
    //--------------------------------------------------------------------------
}
print_verbose('--------------------------------------------------------------------------');
//------------------------------------------------------------------------------
print_debug('images');
print 'iqatest.results.images = ' . json_encode($images) . ';';
print "\n";
print "\n";
//------------------------------------------------------------------------------
print_debug('image_indexes');
print 'iqatest.results.image_indexes = ' . json_encode($image_indexes) . ';';
print "\n";
print "\n";
//------------------------------------------------------------------------------
print_debug('image_comparisons');
print 'iqatest.results.image_comparisons = ' . json_encode($image_comparisons) . ';';
print "\n";
print "\n";
function process_results_to_array($results_exported_file_name)
{
    //##### TODO: clean up this
    //global $verbose;
    // $results_exported is instantiated
    require_once $results_exported_file_name;
    assert(isset($results_exported));
    // $results_exported has the results that were submitted
    print_verbose('results_exported: ' . print_r($results_exported, true));
    //--------------------------------------------------------------------------
    $results_array = array();
    //--------------------------------------------------------------------------
    assert(array_key_exists('id', $results_exported));
    assert(array_key_exists('ip_address', $results_exported));
    assert(array_key_exists('host_name', $results_exported));
    assert(array_key_exists('user_agent', $results_exported));
    $results_array['id'] = $results_exported['id'];
    $results_array['ip_address'] = $results_exported['ip_address'];
    $results_array['host_name'] = $results_exported['host_name'];
    $results_array['user_agent'] = $results_exported['user_agent'];
    //--------------------------------------------------------------------------
    assert(array_key_exists('screen_properties', $results_exported));
    //$results_array['screen_properties'] = $results_exported['screen_properties'];
    //$results_array += $results_exported['screen_properties'];
    $results_array['screen_properties'] = implode('x', $results_exported['screen_properties']);
    //--------------------------------------------------------------------------
    assert(array_key_exists('participant_information', $results_exported));
    //$results_array['participant_information'] = $results_exported['participant_information'];
    $results_array += $results_exported['participant_information'];
    //--------------------------------------------------------------------------
    assert(array_key_exists('image_sets', $results_exported));
    assert(array_key_exists('image_set_indexes', $results_exported));
    assert(array_key_exists('images', $results_exported));
    assert(array_key_exists('image_indexes', $results_exported));
    assert(array_key_exists('image_comparisons', $results_exported));
    //--------------------------------------------------------------------------
    /*
    $image_set_order = array();
    
    foreach ($results_exported['image_set_indexes'] as $image_set_index)
    {
    	$image_set_name = $results_exported['image_sets'][$image_set_index];
    
    	$image_set_order[] = $image_set_name;
    }
    
    $results_array['image_set_order'] = implode(',', $image_set_order);
    */
    $results_array['image_set_order'] = implode(',', $results_exported['image_set_indexes']);
    //--------------------------------------------------------------------------
    $image_order = array();
    //foreach ($results_exported['image_indexes'] as /*$image_set_index =>*/ $image_set)
    foreach ($results_exported['image_indexes'] as $image_set_index => $image_set) {
        $image_order[$image_set_index] = implode(',', $image_set);
        //$image_order[] = implode(',', $image_set);
    }
    $results_array['image_order'] = $image_order;
    //--------------------------------------------------------------------------
    $image_comparisons = array();
    foreach ($results_exported['image_comparisons'] as $image_set_index => $image_set) {
        $image_set_name = $results_exported['image_sets'][$image_set_index];
        $image_comparisons[$image_set_name] = array();
        foreach ($image_set as $image_index => $image_comparison) {
            $image_name = $results_exported['images'][$image_set_index][$image_index];
            $image_comparisons[$image_set_name][$image_name] = $image_comparison;
        }
    }
    $results_array += $image_comparisons;
    //--------------------------------------------------------------------------
    return $results_array;
}
        assert($line !== false);
        $line = trim($line);
        if (empty($line)) {
            continue;
        }
        list($distorted_image, $ssim) = explode(',', $line);
        $distorted_image_ssim_array[$distorted_image] = $ssim;
    }
    assert(fclose($fp));
    assert(!empty($distorted_image_ssim_array));
    print_verbose('distorted_image_ssim_array: ' . print_r($distorted_image_ssim_array, true));
    //--------------------------------------------------------------------------
    $distorted_images = array();
    foreach (range($ssim_min, $ssim_max, $ssim_inc) as $ssim) {
        $distorted_image = closest_value($distorted_image_ssim_array, $ssim);
        $distorted_images[$distorted_image] = $distorted_image_ssim_array[$distorted_image];
    }
    assert(!empty($distorted_images));
    print_verbose('distorted_images: ' . print_r($distorted_images, true));
    $distorted_images_keys = array_keys($distorted_images);
    print_verbose('distorted_images_keys: ' . print_r($distorted_images_keys, true));
    if ($limit != 0) {
        // calling 'count' every iteration is inefficient yet acceptable
        while (count($distorted_images_keys) > $limit) {
            array_pop($distorted_images_keys);
        }
    }
    print_verbose('distorted_images_keys: ' . print_r($distorted_images_keys, true));
    print implode(',', $distorted_images_keys);
    print "\n";
}