Powered by Zoomin Software. For more details please contactZoomin

Semaphore Semantic Enhancement Server (SES) API Reference

The “concepts” command

  • Last Updated: October 30, 2026
  • 3 minute read
    • Semaphore
    • Documentation

<meta name="title" content="The "concepts" command"/> | | REST request: | http://localhost:8983/ses/SpaceMissions/concepts/armstrong | http://localhost:8983/ses/SpaceMissions/concepts/armstrong.json | | CGI request: | http://localhost:8983/ses/?TBDB=SpaceMissions&service=conceptmap&query=armstrong | http://localhost:8983/ses/?TBDB=SpaceMissions&service=conceptmap&query=armstrong&template=service.json |

Response

XML

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<SEMAPHORE>
    <PARAMETERS>
        <PARAMETER NAME="relatedconceptlimit">10000</PARAMETER>
        <PARAMETER NAME="q">conceptmap_en_plf:armstrong^1000.0  conceptmap_en_f:armstrong^100.0  conceptmap_en_pl:armstrong^10.0  conceptmap_en:armstrong^1.0 </PARAMETER>
        <PARAMETER NAME="pathelementlimit">10000</PARAMETER>
        <PARAMETER NAME="stop_cm_after_stage">2</PARAMETER>
        <PARAMETER NAME="fl">json_en prefLabelCount:termfreq(conceptmap_en_plf, "armstrong") altLabelCount:termfreq(conceptmap_en_f, "armstrong")</PARAMETER>
        <PARAMETER NAME="language">en</PARAMETER>
        <PARAMETER NAME="language">en</PARAMETER>
        <PARAMETER NAME="language">en</PARAMETER>
        <PARAMETER NAME="language">en</PARAMETER>
        <PARAMETER NAME="sort">score desc, name_en_pl asc</PARAMETER>
        <PARAMETER NAME="rows">1000</PARAMETER>
        <PARAMETER NAME="version">1</PARAMETER>
        <PARAMETER NAME="wt">sesConceptsXML</PARAMETER>
        <PARAMETER NAME="structure">XML</PARAMETER>
        <PARAMETER NAME="command">conceptmap</PARAMETER>
    </PARAMETERS>
    <TERMS count="1">
        <TERM URI="http://models.smartlogic.com/SpaceMissions#Neil_Armstrong">
            <NAME>Neil Armstrong</NAME>
            <ID>01e1fb66-05c6-47c6-8907-ab6c499e27e9</ID>
            <DISPLAY_NAME>Neil Armstrong</DISPLAY_NAME>
            <FREQUENCY>0</FREQUENCY>
            <CREATED_DATE>2021-10-05T14:56:04+0000</CREATED_DATE>
            <MODIFIED_DATE>2021-10-05T14:56:04+0000</MODIFIED_DATE>
            <CLASSES>
                <CLASS>Astronaut</CLASS>
            </CLASSES>
            <FACETS>
                <FACET ID="bfc33274-197f-4873-a1f4-f421c8ab64aa" NAME="People"/>
            </FACETS>
            <SYNONYMS TYPE="Use For">
                <SYNONYM>Mr. Armstrong</SYNONYM>
                <SYNONYM>Mr. Armstrong (the astronaut)</SYNONYM>
                <SYNONYM>NAA</SYNONYM>
                <SYNONYM>Neil Alden Armstrong</SYNONYM>
            </SYNONYMS>
            <HIERARCHY QTY="2" TYPE="Broader Term">
                <FIELD FREQ="0" ID="58290695-5de3-4bd2-906d-115db43f99e2" NAME="Man in Space Soonest">
                    <CLASS NAME="Programme"/>
                </FIELD>
                <FIELD FREQ="0" ID="51a4417a-423c-482c-a909-991efeeb0c55" NAME="NASA">
                    <CLASS NAME="Organization"/>
                </FIELD>
            </HIERARCHY>
            <ASSOCIATED QTY="2" TYPE="crewed">
                <FIELD FREQ="0" ID="493cb4f5-102f-4492-a766-449ff1eba891" NAME="Apollo 11">
                    <CLASS NAME="Mission"/>
                </FIELD>
                <FIELD FREQ="0" ID="c7e635bc-c731-4494-ab1d-ba5dbcc85a86" NAME="Gemini 8">
                    <CLASS NAME="Mission"/>
                </FIELD>
            </ASSOCIATED>
            <PATH TYPE="Narrower Term">
                <FIELD FREQ="0" ID="bfc33274-197f-4873-a1f4-f421c8ab64aa" NAME="People">
                    <CLASS NAME="Concept Scheme"/>
                </FIELD>
                <FIELD FREQ="0" ID="58290695-5de3-4bd2-906d-115db43f99e2" NAME="Man in Space Soonest">
                    <CLASS NAME="Programme"/>
                </FIELD>
                <FIELD FREQ="0" ID="01e1fb66-05c6-47c6-8907-ab6c499e27e9" NAME="Neil Armstrong">
                    <CLASS NAME="Astronaut"/>
                </FIELD>
            </PATH>
            <PATH TYPE="Narrower Term">
                <FIELD FREQ="0" ID="bfc33274-197f-4873-a1f4-f421c8ab64aa" NAME="People">
                    <CLASS NAME="Concept Scheme"/>
                </FIELD>
                <FIELD FREQ="0" ID="51a4417a-423c-482c-a909-991efeeb0c55" NAME="NASA">
                    <CLASS NAME="Organization"/>
                </FIELD>
                <FIELD FREQ="0" ID="01e1fb66-05c6-47c6-8907-ab6c499e27e9" NAME="Neil Armstrong">
                    <CLASS NAME="Astronaut"/>
                </FIELD>
            </PATH>
            <METADATA>
                <FIELD NAME="Illustration">&lt;img src="https://images.smartlogic.com/SpaceMissions/NeilArmstrong.jpg" width="200" /&gt;</FIELD>
                <FIELD NAME="URI">http://models.smartlogic.com/SpaceMissions#Neil_Armstrong</FIELD>
                <FIELD NAME="Wikidata URI">http://www.wikidata.org/entity/Q1615</FIELD>
                <FIELD NAME="DBPedia URI">http://dbpedia.org/resource/Neil_Armstrong</FIELD>
            </METADATA>
        </TERM>
    </TERMS>
</SEMAPHORE>

JSON

{
  "parameters" : {
    "relatedconceptlimit" : "10000",
    "q" : "conceptmap_en_plf:armstrong^1000.0  conceptmap_en_f:armstrong^100.0  conceptmap_en_pl:armstrong^10.0  conceptmap_en:armstrong^1.0 ",
    "pathelementlimit" : "10000",
    "stop_cm_after_stage" : "2",
    "fl" : "json_en prefLabelCount:termfreq(conceptmap_en_plf, \"armstrong\") altLabelCount:termfreq(conceptmap_en_f, \"armstrong\")",
    "language" : "\"en\", \"en\", \"en\", \"en\"",
    "sort" : "score desc, name_en_pl asc",
    "rows" : "1000",
    "version" : "1",
    "wt" : "sesConceptsJSON",
    "structure" : "JSON",
    "command" : "conceptmap"
  },
  "terms" : [ {
    "term" : {
      "name" : "Neil Armstrong",
      "displayName" : "Neil Armstrong",
      "id" : "01e1fb66-05c6-47c6-8907-ab6c499e27e9",
      "uri" : "http://models.smartlogic.com/SpaceMissions#Neil_Armstrong",
      "classes" : [ "Astronaut" ],
      "facets" : [ {
        "name" : "People",
        "freq" : 0,
        "id" : "bfc33274-197f-4873-a1f4-f421c8ab64aa"
      } ],
      "freq" : "0",
      "documents" : "0",
      "createdDate" : "2021-10-05T14:56:04+0000",
      "lastUpdatedDate" : "2021-10-05T14:56:04+0000",
      "metadata" : {
        "Illustration" : [ "<img src=\"https://images.smartlogic.com/SpaceMissions/NeilArmstrong.jpg\" width=\"200\" />" ],
        "URI" : "http://models.smartlogic.com/SpaceMissions#Neil_Armstrong",
        "Wikidata URI" : [ "http://www.wikidata.org/entity/Q1615" ],
        "DBPedia URI" : [ "http://dbpedia.org/resource/Neil_Armstrong" ]
      },
      "equivalence" : [ {
        "name" : "Use For",
        "fields" : [ {
          "field" : {
            "name" : "Mr. Armstrong"
          }
        }, {
          "field" : {
            "name" : "Mr. Armstrong (the astronaut)"
          }
        }, {
          "field" : {
            "name" : "NAA"
          }
        }, {
          "field" : {
            "name" : "Neil Alden Armstrong"
          }
        } ]
      } ],
      "hierarchy" : [ {
        "qty" : "2",
        "name" : "Broader Term",
        "fields" : [ {
          "field" : {
            "classes" : [ "Programme" ],
            "name" : "Man in Space Soonest",
            "freq" : 0,
            "id" : "58290695-5de3-4bd2-906d-115db43f99e2"
          }
        }, {
          "field" : {
            "classes" : [ "Organization" ],
            "name" : "NASA",
            "freq" : 0,
            "id" : "51a4417a-423c-482c-a909-991efeeb0c55"
          }
        } ]
      } ],
      "associated" : [ {
        "qty" : "2",
        "name" : "crewed",
        "fields" : [ {
          "field" : {
            "classes" : [ "Mission" ],
            "name" : "Apollo 11",
            "freq" : 0,
            "id" : "493cb4f5-102f-4492-a766-449ff1eba891"
          }
        }, {
          "field" : {
            "classes" : [ "Mission" ],
            "name" : "Gemini 8",
            "freq" : 0,
            "id" : "c7e635bc-c731-4494-ab1d-ba5dbcc85a86"
          }
        } ]
      } ],
      "paths" : [ {
        "path" : [ {
          "field" : {
            "classes" : [ "Concept Scheme" ],
            "name" : "People",
            "freq" : 0,
            "id" : "bfc33274-197f-4873-a1f4-f421c8ab64aa"
          }
        }, {
          "field" : {
            "classes" : [ "Programme" ],
            "name" : "Man in Space Soonest",
            "freq" : 0,
            "id" : "58290695-5de3-4bd2-906d-115db43f99e2"
          }
        }, {
          "field" : {
            "classes" : [ "Astronaut" ],
            "name" : "Neil Armstrong",
            "freq" : 0,
            "id" : "01e1fb66-05c6-47c6-8907-ab6c499e27e9"
          }
        } ],
        "name" : "Narrower Term"
      }, {
        "path" : [ {
          "field" : {
            "classes" : [ "Concept Scheme" ],
            "name" : "People",
            "freq" : 0,
            "id" : "bfc33274-197f-4873-a1f4-f421c8ab64aa"
          }
        }, {
          "field" : {
            "classes" : [ "Organization" ],
            "name" : "NASA",
            "freq" : 0,
            "id" : "51a4417a-423c-482c-a909-991efeeb0c55"
          }
        }, {
          "field" : {
            "classes" : [ "Astronaut" ],
            "name" : "Neil Armstrong",
            "freq" : 0,
            "id" : "01e1fb66-05c6-47c6-8907-ab6c499e27e9"
          }
        } ],
        "name" : "Narrower Term"
      } ]
    }
  } ],
  "total" : "1"
}
Alert