The “concepts” command
- Last Updated: May 13, 2026
- 3 minute read
- Semaphore
- Documentation
The “concepts” command will return terms within the model that are related to the supplied query term. This command can be combined with one or more filter parameters so that only a subsection of the model is interrogated.
| Request | XML output | JSON output |
|---|---|---|
| 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 |
Additional Parameter Options
- callback
- childLimit
- class
- cm_stages
- facet
- filter
- language
- maxresultcount
- mindocs
- relatedConceptLimit
- stop_cm_after_stage
- timezone
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"><img src="https://images.smartlogic.com/SpaceMissions/NeilArmstrong.jpg" width="200" /></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"
}