Teseo — User Manual

1. What is Teseo?

Teseo is an application for exploring the relationships contained in a documentary graph.

It allows you to:

The interface is available in Spanish and English.

2. Language

The language selector is located in the application header.

Available languages are:

Teseo remembers the last selected language in the browser.

If no preference has been stored yet, it uses the browser language when it is Spanish or English. Otherwise, Spanish is used.

The language can be changed at any time without losing the current view.

3. Corpus status

The home page contains a Corpus status section.

When the graph is available, it displays:

The Available status means Teseo is ready for queries.

If the service or corpus cannot be accessed, Unavailable is displayed.

4. Search nodes

Search is the main entry point into Teseo.

Search text

Enter the term you want to find, for example:

Pablo Ruiz Picasso
Málaga
museum

Searches are case-insensitive and diacritic-insensitive.

For example:

Málaga
malaga
MÁLAGA

are treated as equivalent.

Field

This determines where the search is performed.

Label

Searches only the node's main name or label.

This is the default option.

Any attribute

Searches all attribute values belonging to a node.

Specific attribute

Allows you to select one attribute from the corpus and search only within that attribute.

Selecting this option displays the Attribute field.

The list of attributes is obtained directly from the graph.

Match

Teseo provides four matching operators.

Contains

The term may occur anywhere in the value.

Example:

Picasso

may find:

Pablo Ruiz Picasso

Exact

The complete value must match the search term.

Starts with

The value must start with the entered text.

In list (IN)

Searches for several exact values at the same time.

Values may be separated by commas or semicolons:

Pablo Ruiz Picasso; Joan Miró, Salvador Dalí

Each item is treated as an exact match. Empty or duplicated values are ignored.

Entity type

Restricts the search to a particular type of node.

All types applies no restriction.

Available types are read directly from the corpus and may therefore change with the data.

Per page

You can choose how many results are displayed:

Runs the query.

Clear

Clears the current search, filters and displayed results.

5. Search results

Results are displayed in a table containing:

When applicable, the searched text is highlighted in the results.

Open a node

Click its label to open the complete node record.

Subgraphs

The Subgraphs action opens the documentary subgraphs containing that node directly.

6. Pagination

When more results exist than fit on one page, the following controls are displayed:

Teseo also displays:

Results X–Y of Z
Page X of Y

The search and current page are represented in the browser address.

You can therefore normally use:

7. Node record

The node record contains the complete information for a node.

The header displays:

The Attributes table follows, with two columns:

Attribute | Value

Attributes containing multiple values display all of them.

Two main actions are available from the node record:

Extract and visualize subgraphs

Reconstructs every documentary subgraph containing the node.

Calculate cooccurrences

Finds other nodes sharing documentary subgraphs with the selected node.

8. Geographic information

When Teseo detects coordinates among a node's attributes, the record automatically includes a Location section.

It contains:

Coordinate values in the attribute table also link to the embedded map.

Teseo additionally recognises geographic attributes equivalent to:

These values become links to Nominatim / OpenStreetMap. Where possible, Teseo uses the rest of the node's geographic context to make the search more precise.

The map is displayed only when recognisable coordinates are available.

9. Documentary subgraphs

A documentary subgraph represents a complete documentary structure associated with the selected node.

Teseo follows graph relationships to identify the corresponding documentary centres or roots and then reconstructs their complete chains.

Expansion may cross several levels and graph cycles are handled safely.

Summary

The view displays four figures:

Subgraphs found

The table contains:

Click the root node label to open its record.

Included by identifies the NID or NIDs whose match caused that documentary root to be included in the extraction.

Large result sets are paginated, 50 subgraphs per page, using Previous and Next.

10. Subgraph visualization

An interactive WebGL representation appears below the list.

The legend identifies:

You can:

Controls

The toolbar provides:

Controls remain disabled while the graph is being prepared.

11. Exporting subgraphs

The same toolbar allows the complete extraction to be exported.

JSON

Exports the subgraph data as JSON.

CSV (ZIP)

Produces tabular CSV data inside a ZIP archive.

XLSX

Produces a Microsoft Excel workbook.

SVG

Exports a vector representation of the graph.

This is the recommended format when the image must later be edited or printed at large size.

PNG 2×

Produces a PNG image at 2× resolution.

PNG 3×

Produces a PNG image at 3× resolution.

While an export is being generated, Teseo displays Generating export…, followed by Export generated when complete.

12. Cooccurrences

Two nodes cooccur when they share at least one documentary subgraph.

The cooccurrence view always starts from a selected node.

Cooccurrence groups

Cooccurring nodes are grouped according to the relation through which they enter the documentary chain.

Each group displays:

This distinction is important: the group describes how the cooccurring node participates in the documentary chain. It does not necessarily represent a direct relationship between that node and the selected node.

Cooccurring nodes

Opening a group displays:

The cooccurrence count indicates how many shared structures were found.

The list is initially sorted by cooccurrence count, from highest to lowest.

The Node and Cooccurrences column headers are interactive:

Node names link directly to their records.

Long lists provide Previous and Next controls.

13. Cooccurrence network

Teseo also produces a graphical representation of all cooccurrences associated with the node.

Each pair of nodes is connected by a single aggregated edge summarising the relationships they share.

The network supports:

It also provides:

14. Exporting cooccurrences

The cooccurrence network supports the same export families:

Data exports contain the complete set of cooccurring nodes rather than only the group currently displayed.

A typical Teseo workflow is:

  1. Search for a person, institution, exhibition, place or other node.
  2. Open its record to inspect its data and attributes.
  3. Use Extract and visualize subgraphs to examine its documentary context.
  4. Click nodes in the graph to continue exploring.
  5. Use Calculate cooccurrences to discover other nodes appearing in the same structures.
  6. Sort cooccurring nodes by frequency to identify the most repeated associations.
  7. Export the data or graph when they need to be preserved or analysed elsewhere.

16. Understanding documentary chains

Teseo edges represent connections towards a documentary centre.

A simplified structure might look like:

actor → artwork → catalogue → exhibition

Teseo can follow these relationships until the relevant centre is reached and then reconstruct the complete documentary structure.

A node may therefore:

The fundamental unit is therefore not only a direct relationship between two nodes, but the complete documentary structure in which they participate.

17. Navigation

Teseo uses internal navigation without fully reloading the application.

You can normally use:

Node records, subgraphs and cooccurrences have their own addresses and can therefore be reloaded directly.

18. Common issues

No results are displayed

Try:

IN does not return the expected results

IN uses exact matching.

Use:

value 1; value 2; value 3

or:

value 1, value 2, value 3

The map is not displayed

The map is generated only when the node contains recognisable coordinates.

The graph is not responding yet

Wait until the status changes from Preparing… to Ready.

No cooccurrences are shown

This means Teseo has not found any other nodes sharing documentary subgraphs with the selected node in the current corpus.

Teseo
Relational exploration of the documentary graph