karolinska 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 46e27f8030e3b7ffdb594d60e71aa45acef8e200
-  data.tar.gz: f69ed370032df5f392337236f7935071827b50ea
+  metadata.gz: bc54653db22d4ec980e3ae52664f2641f6457621
+  data.tar.gz: 31139b2b11bf17c530cf04c78725dbed0deb6d51
 SHA512:
-  metadata.gz: fb86d46bdd109e84562e8ea3f4d4bd7d24ed82fbcfda37cd510dd9f8444fc0a2b9daeaaba773d1d41b4d551fea0cc7f34c65cedca200993fa7632e52e617a871
-  data.tar.gz: 11f27ddc344b14a85736d294a0e64341f562164b6adcc95a27e2b9a57922a9d5212b50cdc7b9a26f39a1439dfe0109c721b78ea65450a79aef8218dbd0b70f05
+  metadata.gz: bd7f048729fec8caa7e7787d0519cdeaa14034e0530486b7e1c6417d1d2d17b44ee26cac9efdc9dc6a8c4557649d81dc66cfd22fbd708eece28b4dfd65339100
+  data.tar.gz: 6bc22d75a74574529d2d4cba01ef35f34065341c96d7a49afe1929dffc172b542edb2cea22ee74805c895fb5749ae8ed0ef45b7009f0998300f421b2786d0dae

data/lib/karolinska/cluster_request.rb

@@ -0,0 +1,59 @@
+module Karolinska
+  class ClusterRequest
+
+    include BenchmarkMethods
+
+    # benchmark :karolinska_request
+
+    require 'net/http/post/multipart'
+
+    ENDPOINT = 'http://35.161.196.215/Dps.aspx?SaveImagesAtServer=true&Timeout=30000'
+    PASSWORD = 'Karolinska'
+
+    def initialize(paths)
+      @paths = paths
+    end
+
+    def start
+      url = URI.parse ENDPOINT
+      request = Net::HTTP::Post::Multipart.new url.path,
+      "file1"  => UploadIO.new(@paths[:front], "image/jpeg", "front.jpg"),
+      "file2"  => UploadIO.new(@paths[:left], "image/jpeg", "left.jpg"),
+      "file3"  => UploadIO.new(@paths[:right], "image/jpeg", "right.jpg"),
+      "file4"  => UploadIO.new(@paths[:up], "image/jpeg", "upward.jpg"),
+      "file5"  => UploadIO.new(@paths[:down], "image/jpeg", "downward.jpg")
+
+      json, status = karolinska_request(request)
+      # Rails.logger.debug json
+      return [json, status]
+    end
+
+    private
+
+    def karolinska_request(request)
+      url = URI.parse ENDPOINT
+      response = Net::HTTP.start(url.host, url.port) do |http|
+        http.request(request)
+      end
+    rescue Timeout::Error => error
+      Rails.logger.error "#{error}".red
+      [nil, error]
+    else
+
+      case response
+      when Net::HTTPOK
+        unless response.body.blank?
+          [JSON.parse(response.body), 200]
+        else
+          Rails.logger.error "Karolinska returned an empty string".red
+          [{}, "Empty String"]
+        end
+      when Net::HTTPClientError, Net::HTTPInternalServerError, Net::HTTPBadResponse, Net::HTTPHeaderSyntaxError, Net::ProtocolError
+        msg = "#{response.class}: #{response.code}, #{response.message}"
+        Rails.logger.error msg.red
+        [{}, msg]
+      end
+
+    end
+  end
+end

data/lib/karolinska/error.rb

@@ -0,0 +1,16 @@
+# From Karolinska 2.2.2 documentation:
+#
+# 400 Bad Request. Bad format.
+# 401 Unauthorized. Authorization error.
+# 403 Forbidden. For example more than five posted images.
+# 408 Request Timeout. Timeout exception.
+# 501 Not Supported. For example not supported image type.
+# 503 Service Unavailable. Web service is unavailable.
+
+module Karolinska
+  class Error
+    class Base < StandardError; end
+
+
+  end
+end

data/lib/karolinska/fake.rb

@@ -0,0 +1,5 @@
+module Karolinska
+  module Fake
+    SET = {"AfroTexture"=>"misses", "Age"=>"15 - 25", "Cheekbones"=>"low (0,88)", "Cheeks"=>"wide (0,57)", "Chin"=>"oval (0,81)", "Corners"=>"up", "CrowFeet"=>"no", "Detected"=>true, "EarLeft"=>"misses", "EarRight"=>"misses", "EyeDistance"=>"normal (0,96)", "EyeSizeLeft"=>"normal (0,68)", "EyeSizeOpposed"=>"big (0,90)", "EyebrowDistance"=>"normal (0,28)", "EyebrowLeftEyedistance"=>"high (0,89)", "EyebrowRightEyedistance"=>"high (0,94)", "Eyecircles"=>"no", "Filtrum"=>"Visible (0.00)", "FiltrumAltitude"=>"high (0,31)", "FiltrumCurvature"=>"concave (0,95)", "Fitted"=>true, "Forehead_central"=>"misses", "Forehead_top"=>"misses", "Forehead_under"=>"misses", "Gender"=>"Male (0,73)", "HairGrade"=>"misses", "HairLength"=>"misses", "HairLow"=>"misses", "HairStretch"=>"misses", "HairStyle"=>"misses", "Iris"=>"normal (0,79)", "Jawbones"=>"normal (0,73)", "LeftCheekbone"=>"small (0,99)", "LeftEarChin"=>"misses", "LeftEarForehead"=>"misses", "LeftEarHeadDistance"=>"misses", "LeftEarLowerChin"=>"misses", "LeftEarNosebridge"=>"misses", "LeftEarNoseroot"=>"misses", "Lines"=>"yes (0.17)", "LipDistDecideBent"=>"straight (0,00)", "LowerLip"=>"thin (0,97)", "MouthSize"=>"normal (0,82)", "MouthWidth"=>"normal (0,21)", "NoseBridge_central"=>"misses", "NoseBridge_top"=>"misses", "NoseBridge_under"=>"misses", "NoseCurve"=>"curveless (0,86)", "NoseLength"=>"long (0,98)", "NoseNostrilsWidth"=>"normal (0,98)", "NoseSideWidth"=>"normal (0,73)", "NoseTipAltitude"=>"high (0,99)", "NoseTipWidthStretch"=>"wide (0,14)", "NoseWidth"=>"normal (0,98)", "OpposedCheekbone"=>"wide (1,00)", "OpposedEarChin"=>"misses", "OpposedEarForehead"=>"misses", "OpposedEarHeadDistance"=>"misses", "OpposedEarLowerChin"=>"misses", "OpposedEarNosebridge"=>"misses", "OpposedEarNoseroot"=>"misses", "UpperLip"=>"thin (0,54)", "VerticalEarDiff"=>"misses", "VerticalMagnitude"=>"normal", "WidthMagnitude"=>"small", "Wrinkle"=>"Visible (1.00)", "interest"=>"misses"}
+  end
+end

data/lib/karolinska/feature_set.rb

@@ -0,0 +1,425 @@
+module Karolinska
+  class FeatureSet < Struct.new( :raw, :view, :statuscode)
+
+    # Use Fakeset: Karolinska::Fake::SET
+    # fs = Karolinska::FeatureSet.new(Karolinska::Fake::SET, :front)
+
+    # => [#<struct Karolinska::FeatureSet raw={"Age"=>"30 - 40", "Cheekbones"=>"average (0,69)", "Cheeks"=>"normal (0,89)", "Chin"=>"oval (0,59)", "Corners"=>"straight", "CrowFeet"=>"yes (1.00)", "Detected"=>true, "EarL
+    # eft"=>"misses", "EarRight"=>"misses", "EyeDistance"=>"normal (0,93)", "EyeSizeLeft"=>"normal (0,66)", "EyeSizeOpposed"=>"small (0,78)", "EyebrowDistance"=>"normal (0,96)", "EyebrowLeftEyedistance"=>"high (0,67)", "
+    # EyebrowRightEyedistance"=>"average (0,91)", "Eyecircles"=>"no", "Filtrum"=>"Visible (0.00)", "FiltrumAltitude"=>"high (0,92)", "FiltrumCurvature"=>"fleet (0,82)", "Fitted"=>true, "Forehead_central"=>"misses", "Fore
+    # head_top"=>"misses", "Forehead_under"=>"misses", "Gender"=>"Female (0,96)", "HairLow"=>"misses", "Iris"=>"normal (0,71)", "Jawbones"=>"wide (0,48)", "LeftCheekbone"=>"wide (1,00)", "LeftEarChin"=>"misses", "LeftEar
+    # Forehead"=>"misses", "LeftEarHeadDistance"=>"misses", "LeftEarLowerChin"=>"misses", "LeftEarNosebridge"=>"misses", "LeftEarNoseroot"=>"misses", "Lines"=>"no", "LipDistDecideBent"=>"misses", "LowerLip"=>"thin (0,98)
+    # ", "MouthSize"=>"normal (0,15)", "MouthWidth"=>"small (0,78)", "NoseBridge_central"=>"misses", "NoseBridge_top"=>"misses", "NoseBridge_under"=>"misses", "NoseCurve"=>"convex (1,00)", "NoseLength"=>"normal (0,99)",
+    # "NoseNostrilsWidth"=>"normal (0,99)", "NoseSideWidth"=>"small (0,88)", "NoseTipAltitude"=>"average (0,92)", "NoseTipWidthStretch"=>"normal (0,85)", "NoseWidth"=>"small (0,87)", "OpposedCheekbone"=>"small (0,99)", "
+    # OpposedEarChin"=>"misses", "OpposedEarForehead"=>"misses", "OpposedEarHeadDistance"=>"misses", "OpposedEarLowerChin"=>"misses", "OpposedEarNosebridge"=>"misses", "OpposedEarNoseroot"=>"misses", "UpperLip"=>"medium
+    # (0,38)", "VerticalEarDiff"=>"misses", "VerticalMagnitude"=>"normal", "WidthMagnitude"=>"small", "Wrinkle"=>"Visible (0.63)", "interest"=>"misses"}, view=:left>]
+
+    # A feature description: "low (0,88)"
+
+    FEATURES = [:age,:center_forehead_width,:cheek_width,:cheeks_height,:cheeks_width,:chin_width,:chin_wrinkles,:crow_feet,:detected,:ear_chin_axis,:ear_lower_chin_axis,:ear_nosebridge_axis,:ear_noseroot_axis,:ear_noseroot_axis,:ear_protruding,:ear_size,:eye_size,:eyebrow_distance,:eyecircles,:eyes_distance,:face_strechiness,:face_width,:filtrum,:fitted,:forehead_protruding,:gender,:iris_orientation,:jaw_width,:left_cheek_width,:left_ear_chin_axis,:left_ear_lower_chin_axis,:left_ear_nosebridge_axis,:left_ear_noseroot_axis,:left_ear_protruding,:left_ear_size,:left_eye_size,:left_eyebrow_eye_distance,:left_forehead_protruding,:lower_forehead_width,:lower_lip_fullness,:mouth_size,:mouth_width,:mouthcorner_orientation,:nose_bottom_width,:nose_center_width,:nose_length,:nose_top_width,:nose_width,:nosetip_orientation,:nosetip_width,:nosewings_width,:nostrills_width,:pallium,:pallium_height,:prominence,:right_cheek_width,:right_ear_chin_axis,:right_ear_lower_chin_axis,:right_ear_nosebridge_axis,:right_ear_noseroot_axis,:right_ear_protruding,:right_ear_size,:right_eye_size,:right_forehead_protruding,:upper_forehead_width,:upper_lip_curvature,:upper_lip_fullness,:wrinkles]
+
+
+    def to_hsh
+      FEATURES.inject({}){|hsh, m| hsh.update({m => self.send(m.to_s)} )}
+    end
+
+
+    def detected
+      raw["Detected"] if raw
+    end
+
+    # Is the detected face fitted (true, false)
+    def fitted
+      raw["Fitted"] if raw
+    end
+
+    # The direction of the face (left, frontal face, right, upwards, downwards), inclusive certainty [0.0, 1.0]
+    # TODO not yet in the result string
+
+    # def face_direction
+    #   rate raw["Gaze"]
+    # end
+
+    # obvious
+    def gender
+      rate raw["Gender"], strong: nil, average: nil, weak: nil
+    end
+
+    # obvious
+    def age
+      raw["Age"] if raw
+    end
+
+    # Prominence part (upper, central, lower) inclusive certainty [0.0, 1.0].
+    def prominence
+      rate raw["interest"], strong: "upper", average: "central", weak: "lower"
+    end
+
+    # Vertical hole between the nose and the upper border of the mouth (visible, notvisible) inclusive certainty [0.0, 1.0]
+    def filtrum
+      rate raw["Filtrum"], strong: "visible", average: nil, weak: "notvisible"
+    end
+
+    # Filtrum (pallium) curvature (convex, fleet, concave), inclusive certainty [0.0, 1.0]
+    def pallium
+      rate raw["FiltrumCurvature"], strong: "convex", average: "fleet", weak: "concave"
+    end
+
+    # filtrum (pallium) altitude (low, average, high), inclusive certainty [0.0, 1.0]
+    def pallium_height
+      rate raw["FiltrumAltitude"], strong: "high", average: "average", weak: "low"
+    end
+
+    # The distance between the eyebrows (close, normal, far apart), inclusive certainty [0.0, 1.0]
+    def eyebrow_distance
+      rate raw["EyebrowDistance"], strong: "far apart", average: "normal", weak: "close"
+    end
+
+    # The distance between the eyebrows and left eye (low, average, high), inclusive certainty [0.0, 1.0]
+    def left_eyebrow_eye_distance
+      rate raw["EyebrowLeftEyedistance"], strong: "high", average: "average", weak: "low"
+    end
+
+    # The distance between the eyebrows and right eye (low, average, high), inclusive certainty [0.0, 1.0]
+    def right_eyebrow_eye_distance
+      rate raw["EyebrowRightEyedistance"], strong: "high", average: "average", weak: "low"
+    end
+
+    # The size of the left eye (small, normal, big), inclusive certainty [0.0, 1.0]
+    def left_eye_size
+      rate raw["EyeSizeLeft"], strong: "big", average: "normal", weak: "small"
+    end
+
+    # The size of the right eye (small, normal, big), inclusive certainty [0.0, 1.0]
+    def right_eye_size
+      rate raw["EyeSizeOpposed"], strong: "big", average: "normal", weak: "small"
+    end
+
+    # Distance between the eyes (close, normal, far apart), inclusive certainty [0.0, 1.0]
+    def eyes_distance
+      rate raw["EyeDistance"], strong: "far apart", average: "normal", weak: "close"
+    end
+
+    # The stretchiness of the face (withdrawn, normal, stretched)
+    def face_strechiness
+      rate raw["VerticalMagnitude"], strong: "stretched", average: "normal", weak: "withdrawn"
+    end
+
+    # The width of the face (small, average, wide)
+    def face_width
+      rate raw["WidthMagnitude"], strong: "wide", average: "average", weak: "small"
+    end
+
+    # The width magnitude of the nose (small, normal, big), inclusive certainty [0.0, 1.0]
+    def nose_width
+      rate raw["NoseWidth"], strong: "big", average: "normal", weak: "small"
+    end
+
+    # The length magnitude of the nose (short, normal, long), inclusive certainty [0.0, 1.0]
+    def nose_length
+      rate raw["NoseLength"], strong: "long", average: "normal", weak: "short"
+    end
+
+    # Width of the nose upper bridge (small, normal, wide)
+    def nose_top_width
+      rate raw["NoseBridge_top"], strong: "wide", average: "normal", weak: "small"
+    end
+
+    # Width of the nose central bridge (small, normal, wide)
+    def nose_center_width
+      rate raw["NoseBridge_central"], strong: "wide", average: "normal", weak: "small"
+    end
+
+    # Width of the nose lower bridge (small, normal, wide)
+    def nose_bottom_width
+      rate raw["NoseBridge_under"], strong: "wide", average: "normal", weak: "small"
+    end
+
+    # Nose tip width stretch (small, normal, wide), inclusive certainty [0.0, 1.0]
+    def nostrills_width
+      rate raw["NoseNostrilsWidth"], strong: "wide", average: "normal", weak: "small"
+    end
+
+    # Nose tip width stretch (small, normal, wide), inclusive certainty [0.0, 1.0]
+    def nosetip_width
+      rate raw["NoseTipWidthStretch"], strong: "wide", average: "normal", weak: "small"
+    end
+
+    # Nose wings width (small, normal, wide), inclusive certainty [0.0, 1.0]
+    def nosewings_width
+      rate raw["NoseSideWidth"], strong: "wide", average: "normal", weak: "small"
+    end
+
+    def nosetip_orientation
+      rate raw["NoseTipAltitude"], strong: "convex", average: "normal", weak: "concave"
+    end
+
+    # Direction of the mouth corners (down, straight, up), inclusive certainty [0.0, 1.0]
+    def mouthcorner_orientation
+      rate raw["Corners"], strong: "wide", average: "normal", weak: "small"
+    end
+
+    # Size of the mouth (small, normal, big), inclusive certainty [0.0, 1.0]
+    def mouth_size
+      rate raw["MouthSize"], strong: "big", average: "normal", weak: "small"
+    end
+
+    # The width of the mouth (small, normal, big), inclusive certainty [0.0, 1.0]
+    def mouth_width
+      rate raw["MouthWidth"], strong: "big", average: "normal", weak: "small"
+    end
+
+    # Upper lip curvature (straight, light curved, deep curved), inclusive certainty [0.0, 1.0]
+    def upper_lip_curvature
+      rate raw["LipDistDecideBent"], strong: "deep curved", average: "light curved", weak: "straight"
+    end
+
+    # The thickness of the upper lip (thin, medium, full), inclusive certainty [0.0, 1.0]
+    def upper_lip_fullness
+      rate raw["UpperLip"], strong: "full", average: "medium", weak: "thin"
+    end
+
+    # The fullness of the lower lip (thin, medium, full), inclusive certainty [0.0, 1.0]
+    def lower_lip_fullness
+      rate raw["LowerLip"], strong: "full", average: "medium", weak: "thin"
+    end
+
+    # The appearance of the chin (round, oval, pointy tip), inclusive certainty [0.0, 1.0]
+    def chin_width
+      rate raw["Chin"], strong: "round", average: "oval", weak: "pointy tip"
+    end
+
+    # The appearance of the jawbones (narrow, normal, wide), inclusive certainty [0.0, 1.0]
+    def jaw_width
+      rate raw["Jawbones"], strong: "wide", average: "normal", weak: "narrow"
+    end
+
+    # The location of the cheekbones (low, average, high), inclusive certainty [0.0, 1.0]
+    def cheeks_height
+      rate raw["Cheekbones"], strong: "high", average: "average", weak: "low"
+    end
+
+    # The width of the left cheekbone (small, normal, wide), inclusive certainty [0.0, 1.0]
+    def left_cheek_width
+      rate raw["LeftCheekbone"], strong: "wide", average: "normal", weak: "small"
+    end
+
+    # The width of the right cheekbone (small, normal, wide), inclusive certainty [0.0, 1.0]
+    def right_cheek_width
+      rate raw["OpposedCheekbone"], strong: "wide", average: "normal", weak: "small"
+    end
+
+    # Width of both cheekbones (small, normal, wide) inclusive certainty [0.0, 1.0]
+    def cheeks_width
+      rate raw["Cheeks"], strong: "wide", average: "normal", weak: "small"
+    end
+
+    # Width of the upper third forehead (small, normal, wide)
+    def upper_forehead_width
+      rate raw["Forehead_top"], strong: "wide", average: "normal", weak: "small"
+    end
+
+    # Width of the central third forehead (small, normal, wide)
+    def center_forehead_width
+      rate raw["Forehead_central"], strong: "wide", average: "normal", weak: "small"
+    end
+
+    # Width of the lower third forehead (small, normal, wide)
+    def lower_forehead_width
+      rate raw["Forehead_under"], strong: "wide", average: "normal", weak: "small"
+    end
+
+    # The size of the left ear (small, normal, big)
+    def left_ear_size
+      rate raw["EarLeft"], strong: "big", average: "normal", weak: "small"
+    end
+
+    # The size of the right ear (small, normal, big)
+    def right_ear_size
+      rate raw["EarRight"], strong: "big", average: "normal", weak: "small"
+    end
+
+    # Vertical ear difference (left higher, equal, right higher)
+    # def ears_diff
+    #   rate raw["VerticalEarDiff"]
+    # end
+
+    # Distance from average left ear center to chin (small, average, large)
+    def left_ear_chin_axis
+      rate raw["LeftEarChin"], strong: "large", average: "average", weak: "small"
+    end
+
+    # Distance from average right ear center to chin (small, average, large)
+    def right_ear_chin_axis
+      rate raw["OpposedEarChin"], strong: "large", average: "average", weak: "small"
+    end
+
+    # Distance from average left ear center to lower chin (small, average, large)
+    def left_ear_lower_chin_axis
+      rate raw["LeftEarLowerChin"], strong: "large", average: "average", weak: "small"
+    end
+
+    # Distance from average right ear center to lower chin (small, average, large)
+    def right_ear_lower_chin_axis
+      rate raw["OpposedEarLowerChin"], strong: "large", average: "average", weak: "small"
+    end
+
+    # Distance from average left ear center to nose upper bridge (small, average, large)
+    def left_ear_nosebridge_axis
+      rate raw["LeftEarNosebridge"], strong: "large", average: "average", weak: "small"
+    end
+
+    # istance from average right ear center to nose upper bridge (small, average, large)
+    def right_ear_nosebridge_axis
+      rate raw["OpposedEarNosebridge"], strong: "large", average: "average", weak: "small"
+    end
+
+    # Distance from average left ear center to nose root (small, average, large)
+    def left_ear_noseroot_axis
+      rate raw["LeftEarNoseroot"], strong: "large", average: "average", weak: "small"
+    end
+
+    # Distance from average right ear center to nose root (small, average, large)
+    def right_ear_noseroot_axis
+      rate raw["OpposedEarNoseroot"], strong: "large", average: "average", weak: "small"
+    end
+
+    # Distance from average left ear center to the forehead (small, average, large)
+    def left_forehead_protruding
+      rate raw["LeftEarForehead"], strong: "large", average: "average", weak: "small"
+    end
+
+    # Distance from average right ear center to the forehead (small, average, large)
+    def right_forehead_protruding
+      rate raw["OpposedEarForehead"], strong: "large", average: "average", weak: "small"
+    end
+
+    # Left ear distance from head (small, average, large)
+    def left_ear_protruding
+      rate raw["LeftEarHeadDistance"], strong: "large", average: "average", weak: "small"
+    end
+
+    # Right ear distance from head (small, average, large)
+    def right_ear_protruding
+      rate raw["OpposedEarHeadDistance"], strong: "large", average: "average", weak: "small"
+    end
+
+    # Chin wrinkle (visible, not visible) inclusive certainty [0.0, 1.0]
+    def chin_wrinkles
+      rate raw["Wrinkle"], strong: "visible", average: nil, weak: "not visible"
+    end
+
+    # Facial lines as exposed by laughing or in the case of wrinkles (yes, no)
+    def wrinkles
+      rate raw["Lines"], strong: "yes", average: "", weak: "no"
+    end
+
+    # Crow features near the outside of the eyes (yes, no) inclusive certainty [0.0, 1.0]
+    def crow_feet
+      rate raw["CrowFeet"], strong: "yes", average: nil, weak: "no"
+    end
+
+    # Iris (upward, normal, downward) inclusive certainty [0.0, 1.0]
+    def iris_orientation
+      rate raw["Iris"], strong: "upward", average: "normal", weak: "downward"
+    end
+
+    # Presence of eye circles below the eye location (no, light, heavy)
+    def eyecircles
+      rate raw["Eyecircles"], strong: "heavy", average: "light", weak: "no"
+    end
+
+    # viewindependet merges below this line:
+
+    def ear_noseroot_axis
+      choose_certain_side left_ear_noseroot_axis, right_ear_noseroot_axis
+    end
+
+    def eye_size
+      choose_certain_side left_eye_size, right_eye_size
+    end
+
+    def cheek_width
+      choose_certain_side left_cheek_width, right_cheek_width
+    end
+
+    def ear_size
+      choose_certain_side left_ear_size, right_ear_size
+    end
+
+    def ear_chin_axis
+      choose_certain_side left_ear_chin_axis, right_ear_chin_axis
+    end
+
+    def ear_lower_chin_axis
+      choose_certain_side left_ear_lower_chin_axis, right_ear_lower_chin_axis
+    end
+
+    def ear_nosebridge_axis
+      choose_certain_side left_ear_nosebridge_axis, right_ear_nosebridge_axis
+    end
+
+    def ear_noseroot_axis
+      choose_certain_side left_ear_noseroot_axis, right_ear_noseroot_axis
+    end
+
+    def forehead_protruding
+      choose_certain_side left_forehead_protruding, right_forehead_protruding
+    end
+
+    def ear_protruding
+      choose_certain_side left_ear_protruding, right_ear_protruding
+    end
+
+
+    private
+
+    # this method rates the analysation and groups it into values of strong / average / weak by attaching integer values of +1, 0 and -1.
+    def rate value, *args
+      return nil if value == "misses"
+      # {certainty: nil, strong: nil, average: nil, weak: nil, description: nil, strength: nil, weight: nil}
+      opts = args.extract_options!
+
+      raise StandardError.new "missing param :strong" if !opts.has_key?(:strong)
+      raise StandardError.new "missing param :average" if !opts.has_key?(:average)
+      raise StandardError.new "missing param :weak" if !opts.has_key?(:weak)
+
+      # autodetect certainty
+      has_certainty = !!value[/\(.+\)/]
+
+
+      out = Hash.new
+      if has_certainty
+
+        out[:certainty]   = value[/(\d[,.]\d+)/].gsub(',', '.').to_f
+        out[:description] = value.remove(/.\(.+\)/)
+      else
+        out[:description] = value
+      end
+
+      out[:weight] = case out[:description].downcase
+      when (opts[:strong] || "").downcase then :strong rescue 0
+      when (opts[:average] || "").downcase then :average rescue false
+      when (opts[:weak] || "").downcase then :weak rescue false
+      end
+      out[:view] = view
+      out
+    end
+
+    def choose_certain_side left, right
+      if (!left.nil? && !right.nil?)
+        order = [left, right]
+        [left, right].sort_by {|side|
+          side[:certainty]
+        }
+        order.last
+      else
+        left || right
+      end
+    end
+
+
+
+
+  end
+end

data/lib/karolinska/feature_sets.rb

@@ -0,0 +1,415 @@
+module Karolinska
+
+  require 'delegate'
+
+	class FeatureSets < DelegateClass(Array)
+
+
+    # fs = Karolinska::TestSet.test_monique
+
+    def to_hsh
+      Karolinska::FeatureSet::FEATURES.inject({}){|hsh, m| hsh.update({m => self.send(m.to_s)} )}
+    end
+
+    def initialize(arr=[])
+      super(arr)
+    end
+
+    def front
+      @front || find{|fs| fs.view == :front}
+    end
+
+    def up
+      @up || find{|fs| fs.view == :up}
+    end
+
+    def down
+      @down || find{|fs| fs.view == :down}
+    end
+
+    def left
+      @left || find{|fs| fs.view == :left}
+    end
+
+    def right
+      @right || find{|fs| fs.view == :right}
+    end
+
+    def without_error
+      collect{|fs| fs.statuscode == 200} || []
+    end
+
+    def detected
+      self.inject({}){|h,s| h.update({s.view => s.detected}); h}
+    end
+
+    # Is the detected face fitted (true, false)
+    def fitted
+      self.inject({}){|h,s| h.update({s.view => s.fitted}); h}
+    end
+
+    def status
+      self.inject({}){|h,s| h.update({s.view => s.statuscode}); h}
+    end
+
+    def views
+      self.collect(&:view)
+    end
+
+    # def face_direction
+    #   rate raw["Gaze"]
+    # end
+
+    # we have a certainty value in gender, so we can preiorize it.
+    def gender
+      priorize(attribute: "gender", left:1, front:1, right:2, up:1, down:1)
+    end
+
+    # Without certainty value, guessing, that the front view has most precise estimation.
+    def age
+      front.age
+    end
+
+    # Prominence part (upper, central, lower) inclusive certainty [0.0, 1.0].
+    def prominence
+      priorize(attribute: "prominence")
+    end
+
+    # Vertical hole between the nose and the upper border of the mouth (visible, notvisible) inclusive certainty [0.0, 1.0]
+    def filtrum
+      priorize(attribute: "filtrum")
+    end
+
+    # Filtrum (pallium) curvature (convex, fleet, concave), inclusive certainty [0.0, 1.0]
+    def pallium
+      priorize(attribute: "pallium")
+    end
+
+    # filtrum (pallium) altitude (low, average, high), inclusive certainty [0.0, 1.0]
+    def pallium_height
+      priorize(attribute: "pallium_height")
+    end
+
+    # The distance between the eyebrows (close, normal, far apart), inclusive certainty [0.0, 1.0]
+    def eyebrow_distance
+      priorize(attribute: "eyebrow_distance")
+    end
+
+    # The distance between the eyebrows and left eye (low, average, high), inclusive certainty [0.0, 1.0]
+    def left_eyebrow_eye_distance
+      priorize(attribute: "left_eyebrow_eye_distance", left: 1, front: 2, right:3)
+    end
+
+    # The distance between the eyebrows and right eye (low, average, high), inclusive certainty [0.0, 1.0]
+    def right_eyebrow_eye_distance
+      priorize(attribute: "right_eyebrow_eye_distance", right: 1, front: 2, left:3 )
+    end
+
+    # The size of the left eye (small, normal, big), inclusive certainty [0.0, 1.0]
+    def left_eye_size
+      priorize(attribute: "left_eye_size", left: 1, front: 2, right:3)
+    end
+
+    # The size of the right eye (small, normal, big), inclusive certainty [0.0, 1.0]
+    def right_eye_size
+      priorize(attribute: "right_eye_size", right: 1, front: 2, left:3)
+    end
+
+    # Distance between the eyes (close, normal, far apart), inclusive certainty [0.0, 1.0]
+    def eyes_distance
+      priorize(attribute: "eyes_distance")
+    end
+
+    # The stretchiness of the face (withdrawn, normal, stretched)
+    def face_strechiness
+      priorize(attribute: "face_strechiness")
+    end
+
+    # The width of the face (small, average, wide)
+    def face_width
+      priorize(attribute: "face_width")
+    end
+
+    # The width magnitude of the nose (small, normal, big), inclusive certainty [0.0, 1.0]
+    def nose_width
+      priorize(attribute: "nose_width")
+    end
+
+    # The length magnitude of the nose (short, normal, long), inclusive certainty [0.0, 1.0]
+    def nose_length
+      priorize(attribute: "nose_length", right:1, left:1, front:2, up:3, down:3, )
+    end
+
+    # Width of the nose upper bridge (small, normal, wide)
+    def nose_top_width
+      priorize(attribute: "nose_top_width")
+    end
+
+    # Width of the nose central bridge (small, normal, wide)
+    def nose_center_width
+      priorize(attribute: "nose_center_width")
+    end
+
+    # Width of the nose lower bridge (small, normal, wide)
+    def nose_bottom_width
+      priorize(attribute: "nose_bottom_width")
+    end
+
+    # Nose tip width stretch (small, normal, wide), inclusive certainty [0.0, 1.0]
+    def nostrills_width
+      priorize(attribute: "nostrills_width")
+    end
+
+    # Nose tip width stretch (small, normal, wide), inclusive certainty [0.0, 1.0]
+    def nosetip_width
+      priorize(attribute: "nosetip_width")
+    end
+
+    # Nose wings width (small, normal, wide), inclusive certainty [0.0, 1.0]
+    def nosewings_width
+      priorize(attribute: "nosewings_width")
+    end
+
+    # Direction of the mouth corners (down, straight, up), inclusive certainty [0.0, 1.0]
+    def mouthcorner_orientation
+      priorize(attribute: "mouthcorner_orientation")
+    end
+
+    # Size of the mouth (small, normal, big), inclusive certainty [0.0, 1.0]
+    def mouth_size
+      priorize(attribute: "mouth_size")
+    end
+
+    # The width of the mouth (small, normal, big), inclusive certainty [0.0, 1.0]
+    def mouth_width
+      priorize(attribute: "mouth_width")
+    end
+
+    # Upper lip curvature (straight, light curved, deep curved), inclusive certainty [0.0, 1.0]
+    def upper_lip_curvature
+      priorize(attribute: "upper_lip_curvature")
+    end
+
+    # The thickness of the upper lip (thin, medium, full), inclusive certainty [0.0, 1.0]
+    def upper_lip_fullness
+      priorize(attribute: "upper_lip_fullness")
+    end
+
+    # The fullness of the lower lip (thin, medium, full), inclusive certainty [0.0, 1.0]
+    def lower_lip_fullness
+      priorize(attribute: "lower_lip_fullness")
+    end
+
+    # The appearance of the chin (round, oval, pointy tip), inclusive certainty [0.0, 1.0]
+    def chin_width
+      priorize(attribute: "chin_width")
+    end
+
+    # The appearance of the jawbones (narrow, normal, wide), inclusive certainty [0.0, 1.0]
+    def jaw_width
+      priorize(attribute: "jaw_width")
+    end
+
+    # The location of the cheekbones (low, average, high), inclusive certainty [0.0, 1.0]
+    def cheeks_height
+      priorize(attribute: "cheeks_height")
+    end
+
+    # The width of the left cheekbone (small, normal, wide), inclusive certainty [0.0, 1.0]
+    def left_cheek_width
+      priorize(attribute: "left_cheek_width")
+    end
+
+    # The width of the right cheekbone (small, normal, wide), inclusive certainty [0.0, 1.0]
+    def right_cheek_width
+      priorize(attribute: "right_cheek_width")
+    end
+
+    # Width of both cheekbones (small, normal, wide) inclusive certainty [0.0, 1.0]
+    def cheeks_width
+      priorize(attribute: "cheeks_width")
+    end
+
+    # Width of the upper third forehead (small, normal, wide)
+    def upper_forehead_width
+      priorize(attribute: "upper_forehead_width")
+    end
+
+    # Width of the central third forehead (small, normal, wide)
+    def center_forehead_width
+      priorize(attribute: "center_forehead_width")
+    end
+
+    # Width of the lower third forehead (small, normal, wide)
+    def lower_forehead_width
+      priorize(attribute: "lower_forehead_width")
+    end
+
+    # The size of the left ear (small, normal, big)
+    def left_ear_size
+      priorize(attribute: "left_ear_size")
+    end
+
+    # The size of the right ear (small, normal, big)
+    def right_ear_size
+      priorize(attribute: "right_ear_size")
+    end
+
+    # Vertical ear difference (left higher, equal, right higher)
+    # def ears_diff
+    #   rate raw["VerticalEarDiff"]
+    # end
+
+    # Distance from average left ear center to chin (small, average, large)
+    def left_ear_chin_axis
+      priorize(attribute: "left_ear_chin_axis", left:1, front:2, right:3)
+    end
+
+    # Distance from average right ear center to chin (small, average, large)
+    def right_ear_chin_axis
+      priorize(attribute: "right_ear_chin_axis", right:1, front:2, left:3)
+    end
+
+    # Distance from average left ear center to lower chin (small, average, large)
+    def left_ear_lower_chin_axis
+      priorize(attribute: "left_ear_lower_chin_axis", left:1, front:2, right:3)
+    end
+
+    # Distance from average right ear center to lower chin (small, average, large)
+    def right_ear_lower_chin_axis
+      priorize(attribute: "right_ear_lower_chin_axis", right:1, front:2, left:3)
+    end
+
+    # Distance from average left ear center to nose upper bridge (small, average, large)
+    def left_ear_nosebridge_axis
+      priorize(attribute: "left_ear_nosebridge_axis", left:1, front:2, right:3)
+    end
+
+    # istance from average right ear center to nose upper bridge (small, average, large)
+    def right_ear_nosebridge_axis
+      priorize(attribute: "right_ear_nosebridge_axis", right:1, front:2, left:3)
+    end
+
+    # Distance from average left ear center to nose root (small, average, large)
+    def left_ear_noseroot_axis
+      priorize(attribute: "left_ear_noseroot_axis", left:1, front:2, right:3)
+    end
+
+    # Distance from average right ear center to nose root (small, average, large)
+    def right_ear_noseroot_axis
+      priorize(attribute: "right_ear_noseroot_axis", right:1, front:2, left:3)
+    end
+
+    # Distance from average left ear center to the forehead (small, average, large)
+    def forehead_protruding
+      priorize(attribute: "forehead_protruding", right:1, left:2, front:3)
+    end
+
+    # Left ear distance from head (small, average, large)
+    def left_ear_protruding
+      priorize(attribute: "left_ear_protruding")
+    end
+
+    # Chin wrinkle (visible, not visible) inclusive certainty [0.0, 1.0]
+    def chin_wrinkles
+      priorize(attribute: "chin_wrinkles")
+    end
+
+    # Facial lines as exposed by laughing or in the case of wrinkles (yes, no)
+    def wrinkles
+      priorize(attribute: "wrinkles")
+    end
+
+    # Crow features near the outside of the eyes (yes, no) inclusive certainty [0.0, 1.0]
+    def crow_feet
+      priorize(attribute: "crow_feet")
+    end
+
+    # Iris (upward, normal, downward) inclusive certainty [0.0, 1.0]
+    def iris_orientation
+      priorize(attribute: "iris_orientation")
+    end
+
+    # Presence of eye circles below the eye location (no, light, heavy)
+    def eyecircles
+      priorize(attribute: "eyecircles")
+    end
+
+    def nosetip_orientation
+      priorize(attribute: "nosetip_orientation")
+    end
+
+    def left_forehead_protruding
+      priorize(attribute: "left_forehead_protruding", left:1, front:2, right:3)
+    end
+
+    def right_forehead_protruding
+      priorize(attribute: "right_forehead_protruding", right:3, front:2, left:1)
+    end
+
+    def right_ear_protruding
+      priorize(attribute: "right_ear_protruding", right:3, front:2, left:1)
+    end
+
+    def ear_noseroot_axis
+      priorize(attribute: "ear_noseroot_axis", left:1, front:2, right:1)
+    end
+
+    def eye_size
+      priorize(attribute: "ear_noseroot_axis")
+    end
+
+    def cheek_width
+      priorize(attribute: "ear_noseroot_axis")
+    end
+
+    def ear_size
+      priorize(attribute: "ear_size")
+    end
+
+    def ear_chin_axis
+      priorize(attribute: "ear_size")
+    end
+
+    def ear_lower_chin_axis
+      priorize(attribute: "ear_size")
+    end
+
+    def ear_nosebridge_axis
+      priorize(attribute: "ear_nosebridge_axis")
+    end
+
+    def ear_protruding
+      priorize(attribute: "ear_protruding")
+    end
+
+
+    private
+
+    # priorize the features by estimated view logically, secondly on the certainty of the given attribute
+    # def priorize(*args)
+    #   prios = {front: 1, left: 2, right: 2, up: 3, down:3}
+    #   @prios = prios.update(args.extract_options!)
+    #   raise StandardError.new "missing param :attribute" if !prios.has_key?(:attribute)
+    #   self.sort_by!{ |fs| [@prios[fs.view], (fs.send(@prios[:attribute])[:certainty] rescue 1) ] }
+    #   self.first.send(@prios[:attribute]) rescue nil
+    # end
+
+    def priorize(*args)
+      @prios = {front: 1, left: 2, right: 2, up: 3, down:3}.update(args.extract_options!)
+      raise Karolinska::Error::Base.new "missing param :attribute" if !@prios.has_key?(:attribute)
+      method = @prios.delete(:attribute)
+      sorted_views = Hash[@prios.sort_by{ |_, v| -v }.reverse].keys
+      sorted_views = sorted_views & views
+
+      feature_values = sorted_views.collect do |view|
+        self.send(view).send(method)
+      end
+
+      feature_values.compact.first
+
+    end
+
+
+  end
+end

data/lib/karolinska/single_request.rb

@@ -0,0 +1,71 @@
+module Karolinska
+  class SingleRequest
+
+    include BenchmarkMethods
+
+    benchmark :karolinska_request
+
+    require 'net/http/post/multipart'
+
+
+    ENDPOINT = 'http://92.111.221.231:85/Fid.aspx'
+    PASSWORD = 'Karolinska'
+
+
+    def initialize(path, view)
+      @path = path
+      @view = case view
+      when :front
+        "Frontal"
+      when :left
+        "Left"
+      when :right
+        "Right"
+      when :up
+        "Upward"
+      when :down
+        "Downward"
+      end
+    end
+
+    def start
+      url = URI.parse ENDPOINT
+      request = Net::HTTP::Post::Multipart.new url.path,
+      "file"  => UploadIO.new(@path, "image/jpeg", "image.jpg"),
+      "Sid"   => PASSWORD,
+      "View"  => @view
+
+      json, status = karolinska_request(request)
+      # Rails.logger.debug json
+      return [json, status]
+    end
+
+    private
+
+    def karolinska_request(request)
+      url = URI.parse ENDPOINT
+      response = Net::HTTP.start(url.host, url.port) do |http|
+        http.request(request)
+      end
+    rescue Timeout::Error => error
+      Rails.logger.error "#{error}".red
+      [nil, error]
+    else
+
+      case response
+      when Net::HTTPOK
+        unless response.body.blank?
+          [JSON.parse(response.body), 200]
+        else
+          Rails.logger.error "Karolinska returned an empty string".red
+          [{}, "Empty String"]
+        end
+      when Net::HTTPClientError, Net::HTTPInternalServerError, Net::HTTPBadResponse, Net::HTTPHeaderSyntaxError, Net::ProtocolError
+        msg = "#{response.class}: #{response.code}, #{response.message}"
+        Rails.logger.error msg.red
+        [{}, msg]
+      end
+
+    end
+  end
+end

data/lib/karolinska/test_set.rb

@@ -0,0 +1,53 @@
+module Karolinska
+  module TestSet
+
+    # usage: Karolinska::TestSet.test_sander
+
+    FILESLOC = "./test/fixtures/files"
+
+    class Person < Struct.new(:name, :res)
+
+      def paths
+        {
+          front:  "#{FILESLOC}/#{name}/#{res}/front.jpg",
+          left:   "#{FILESLOC}/#{name}/#{res}/left.jpg",
+          right:  "#{FILESLOC}/#{name}/#{res}/right.jpg",
+          up:     "#{FILESLOC}/#{name}/#{res}/up.jpg",
+          down:   "#{FILESLOC}/#{name}/#{res}/down.jpg"
+        }
+      end
+
+    end
+
+    # usage: Karolinska::TestSet.test_peter
+    def self.test_peter
+      paths = Person.new("peter", "highres").paths
+      paths.delete(:up)
+      paths.delete(:down)
+      Karolinska::Scan.new(paths).connect
+    end
+
+    # usage: Karolinska::TestSet.test_sander
+    def self.test_sander
+      Karolinska::Scan.new(Person.new("sander", "lowres").paths).connect
+    end
+
+    # usage: Karolinska::TestSet.test_monique
+    def self.test_monique
+      Karolinska::Scan.new(Person.new("monique", "lowerres").paths).connect(true)
+    end
+
+    def self.test_marcus
+      Karolinska::Scan.new(Person.new("marcus", "lowerres").paths).connect
+    end
+
+    def self.test_marieke
+      Karolinska::Scan.new(Person.new("marieke", "lowerres").paths).connect
+    end
+
+    def self.test_chris
+      Karolinska::Scan.new(Person.new("chris", "lowres").paths).connect
+    end
+
+  end
+end

data/lib/karolinska/version.rb

@@ -1,3 +1,3 @@
 module Karolinska
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: karolinska
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Sebastian Arcila Valenzuela
@@ -69,6 +69,13 @@ files:
 - bin/setup
 - karolinska.gemspec
 - lib/karolinska.rb
+- lib/karolinska/cluster_request.rb
+- lib/karolinska/error.rb
+- lib/karolinska/fake.rb
+- lib/karolinska/feature_set.rb
+- lib/karolinska/feature_sets.rb
+- lib/karolinska/single_request.rb
+- lib/karolinska/test_set.rb
 - lib/karolinska/version.rb
 homepage: http://your.mom
 licenses: []