Paooooo / Steatite

Pictures archive for qualitative analysis

Steatite – Pictures archive for qualitative analysis

License: GNU Affero General Public License

Contact: [e-mail]

Home page: https://github.com/Hypertopic/Steatite

Notice

Steatite is a server software. There is no need to install it on your own computer to use it. The usual way is to be "hosted" by one's own institution (ask your system administrator). If your use cases meet our research interests, we can also host your data on our community server.

Installation requirements

• Git client
• Apache HTTP server with PHP and rewrite module
• Netpbm (Linux, MacOS X, Mingw32)
• ExifTool
• SQLite 3

Installation procedure

• In a Web folder:

    git clone [e-mail]:Hypertopic/Steatite.git
    cd Steatite
    mkdir -m 755 picture thumbnail attribute
    sqlite3 attribute/database <schema.sql
    chown -R www-data picture thumbnail attribute
  

• If the last command threw an error, your system may use a different username for Apache-owned files. Change it accordingly.

• Set Apache PATH environment to include mkdir, file and anytopnm (see wiki for OS-dependent procedures).

• In /etc/php5/apache2/php.ini (or equivalent), set upload_max_filesize, max_file_uploads and post_max_size high enough for your mass uploading needs.

Features

Steatite is a service of image analysis designed in accordance with the Hypertopic protocol. Thus for compatibily reasons, some services had to be implemented but does not have really interest for Steatite. That's why some services are implemented but will return an empty JSON table. See Hypertopic Protocol for more informations. Here's a description of the features offered by Steatite. For each features, you have the pattern of the request followed with an example.

To display a picture

The picture will be displayed in the format it was initially upload.

picture/{image hash}

Picture Example

To display a thumbnail

Type thumbnail instead of picture in your request.

thumbnail/{image hash}

To display a fragment of a thumbnail

You can display only a fragment of a thumbnail by adding four coordinates, each separated with a + at the end of your request. The four digits are coordinates - in pixels - that represents two points in the original image and create a rectangle that will be the diplayed fragment. The two first digits are the coordinates of the first point, respectively the abscissa and ordinate. The third and fourth digits are respectively the abscissa and ordinate of the second point.

thumbnail/{image hash}/{x1}+{y1}+{x2}+{y2}

For example if you want to display only the face of the character at the left of the picture, you can type this :

http://steatite.hypertopic.org/thumbnail/c4ced98095164137e2df8ab7aa6e9e3740b12a96/300+450+850+1000

Here's what you will get :

To display attributes related to an item in JSON format

You can access to the metadatas related to a picture or thumbnail by typing item in your request. Thus, you will access to the picture or thumbnail id, name, the date on which the picture was taken and possibly the localisation of the picture if this attribute is available for the picture.

item/{corpus name}/{image hash}

http://steatite.hypertopic.org/item/Vitraux%20-%20Bénel/c4ced98095164137e2df8ab7aa6e9e3740b12a96

  {
    "rows":[
      {
        "key":["Vitraux - Bénel", "c4ced98095164137e2df8ab7aa6e9e3740b12a96", 
      "value":
              {
                "name":"GRD 002"
              }
      },
      {
        "key":["Vitraux - Bénel", "c4ced98095164137e2df8ab7aa6e9e3740b12a96", 
      "value":
                {
                  "resource":"http://steatite.hypertopic.org/picture/c4ced98095164137e2df8ab7aa6e9e3740b12a96"
                }
      },
      {
        "key":["Vitraux - Bénel", "c4ced98095164137e2df8ab7aa6e9e3740b12a96", 
      "value":
                {
                  "thumbnail":"http://steatite.hypertopic.org/thumbnail/c4ced98095164137e2df8ab7aa6e9e3740b12a96"
                }
      },
      {
        "key":["Vitraux - Bénel", "c4ced98095164137e2df8ab7aa6e9e3740b12a96"],
       "value":
                {
                  "created":"2019-02-24"
                }
      },
      {
        "key":["Vitraux - Bénel", "c4ced98095164137e2df8ab7aa6e9e3740b12a96"], 
      "value":
                {
                  "spatial":"48 deg 18' 26.88\" N, 4 deg 19' 18.32\" E"
                }
      }
    ]
  }

To display attributes in XML format

entity/{image hash}

  <entity>
    <attribute name="type" value="source"/>
    <attribute name="name" value="Amp15b.jpg"/>
    <resource name="thumbnail" href="http://steatite.hypertopic.org/thumbnail/0f9fa45500958406f667075d66180582d735d6c1"/>
    <resource name="source" href="http://steatite.hypertopic.org/picture/0f9fa45500958406f667075d66180582d735d6c1"/>
  </entity>

To access all the items of a corpus

You can access to the list of all pictures contained in a corpus.

^corpus/{corpus name}

  {
    "rows":[
      {"key":["Vitraux - Bénel"], "value":{"name":"Vitraux - Bénel"}}, 
        {"key":["Vitraux - Bénel", "e40b04e31b74f8ebb32a63525cc0efe7e7278193"], "value":{"name":"SNC"}},
        {"key":["Vitraux - Bénel", "e40b04e31b74f8ebb32a63525cc0efe7e7278193"], "value":{"resource":"http://steatite.hypertopic.org/picture/e40b04e31b74f8ebb32a63525cc0efe7e7278193"}},
        {"key":["Vitraux - Bénel", "e40b04e31b74f8ebb32a63525cc0efe7e7278193"], "value":{"thumbnail":"http://steatite.hypertopic.org/thumbnail/e40b04e31b74f8ebb32a63525cc0efe7e7278193"}}, 
        {"key":["Vitraux - Bénel", "7b0006e98ec564021778cf585cae3adec07f4389"], "value":{"name":"SJ"}},
        {"key":["Vitraux - Bénel", "7b0006e98ec564021778cf585cae3adec07f4389"], "value":{"resource":"http://steatite.hypertopic.org/picture/7b0006e98ec564021778cf585cae3adec07f4389"}},
        {"key":["Vitraux - Bénel", "7b0006e98ec564021778cf585cae3adec07f4389"], "value":{"thumbnail":"http://steatite.hypertopic.org/thumbnail/7b0006e98ec564021778cf585cae3adec07f4389"}}, 
        {"key":["Vitraux - Bénel", "1b0283c79d33afd06eed5abb46a836b4c235e4b3"], "value":{"name":"SNZ"}},
        {"key":["Vitraux - Bénel", "1b0283c79d33afd06eed5abb46a836b4c235e4b3"], "value":{"resource":"http://steatite.hypertopic.org/picture/1b0283c79d33afd06eed5abb46a836b4c235e4b3"}},
        {"key":["Vitraux - Bénel", "1b0283c79d33afd06eed5abb46a836b4c235e4b3"], "value":{"thumbnail":"http://steatite.hypertopic.org/thumbnail/1b0283c79d33afd06eed5abb46a836b4c235e4b3"}}
      // ...
    ]
  }