User manual

Atlas Composer

A complete guide to creating and managing historical, genealogical and geographic visualisations. How each element works, what it is for and how to configure it.

🖥️

Views

Four ways to explore and visualise the same content

timeline

Atlas

Main view. Thematic columns, time spans and events along a chronological axis.

public

Map

Geolocated events and areas on OpenStreetMap. Filterable by year.

account_tree

Family tree

People connected by family relationships. Filterable by year of life.

menu_book

Bibliography

Panel of bibliographic sources. Books, articles, websites, documentaries and podcasts linked to notes.

💡

The views share the same elements: a Point can appear in the atlas, on the map and in the tree at the same time without being duplicated.

🧱

Creating an atlas

The first decision, which shapes the whole project

What you need to define first

When you create a Graph, the most important choice is the dating type: it determines how all the content is positioned on the time axis, and it cannot be changed once you have added elements.

Next you decide which views to enable (timeline atlas, map, family tree) and whether the graph will be public or private. The rest of the configuration can be adjusted at any time.

Absolute dating

Historical

The time axis uses real years. Positive years are AD and negative years are BC. Each element is placed on the axis according to its exact year, so the visual distance between two events reflects the real time distance between them.

When to use it: whenever your events have specific or approximate dates. It is the default type for history, genealogy and historical geography.

📅

Examples: medieval history (722 – 1492), a biography (1920 – 2005), the evolution of a city (1800 – today).

Relative dating

No dates

The time axis uses relative numbers with no year scale. You define what each number means: they can be the phases of a process (1, 2, 3…), generations, chapters, stages of a cycle or any other unit of your own.

When to use it: when the content has no specific dates, or when you want to compare structures without anchoring them to real time. Ideal for work processes, narratives, biological cycles, methodologies and comparisons between different periods.

🔢

Examples: the phases of a project (phase 1, 2, 3…), the life cycle of a species, the acts of a play, the stages of an industrial process.

⚠️

Irreversible: the dating type cannot be changed once you have created Columns, Collections or Points inside the graph. Decide before you start adding content.

Fields

New graph form

FieldWhat it is for
NameName of the project. It appears in the header and in the list of graphs. Required.
DescriptionDescription of the project. Useful for stating its scope or theme.
TypeAbsolute or Relative, as explained above. Required. It cannot be changed afterwards.
PublicIf enabled, anyone with the link can view the graph without signing in. It is private by default.
Active viewsIn edit mode the three views (atlas, map and family tree) are always available. In read mode only the views that have content appear in the menu.
Large textIncreases the text size of the atlas elements to improve legibility on large screens or projectors.
timeline

Atlas

📐

How the atlas is built

How the timeline is visually put together

Visual structure

The atlas is a grid view where the vertical axis represents time and the horizontal axis groups the content into Columns.

On the left there is a fixed bar of years (the time axis). Each year mark has a horizontal line running across all the columns as a reference.

Visual elements on screen

ElementHow it appears
ColumnColumn header at the bottom of the screen, with the configured name and colour. Columns can be reordered with the arrow buttons in edit mode.
CollectionA block inside a column. If it has a start and end year defined, it is positioned on the time axis at the corresponding height. If it has no dates, it appears off the axis.
PhaseA coloured vertical band covering the height that matches its range of years. It can overlap with Collections, using the position field to spread them across lanes.
PointA dot and text label placed at the year of the event. In absolute mode they are placed on the vertical axis according to their exact year or the start of the range.

Scale cuts

By default the time axis is linear: every year takes up the same space. If your graph mixes very different periods (e.g. geological history with modern history), you can define scale cuts so that each segment has its own proportion.

For example: a cut at year 0 splits the axis into two segments (prehistory and the modern era), each with its own independent visual scale. Each segment takes up the same height on screen.

This is configured from the Scale cuts icon (straighten) in the top menu (“Editing” block), in edit mode.

✅

Clicking a Collection, Phase or Point in the atlas opens the information panel (on the right of the screen) with its description, related Points and notes.

🗂️

Data hierarchy

How all the elements relate to each other

Graph — root container
Column — thematic column
Collection — group of events
Phase — time span
Point — event or person
Note — notes on any element
Area — polygons on the map
Bibliography — bibliographic sources
💡

Golden rule: Graph → Column → Collection → Point. You cannot create a Point without a Collection, nor a Collection without a Column.

🔍

Importance system

Controls which elements are visible depending on the atlas zoom level

Each Collection, Phase and Point has an importance value (0–5). When the atlas zoom is low (distant view), only low-importance elements are shown. As you zoom in, the higher-valued ones gradually appear.


0Always visible, regardless of zoom
1Very important — visible from the most distant view
2Important
3Normal — recommended default value
4Detail — only visible when zoomed in
5Very detailed — only at the maximum zoom level
✅

Start with everything at 3. Once the graph has a lot of content, lower the most important events to 1–2 and raise the secondary ones to 4–5.

📊

Column

First level of thematic grouping within a Graph

Description

What is it for?

Each Column takes up one vertical column in the atlas. It is used to separate content by theme: Politics, Culture, Economy, Military, or by groups of people in a genealogy.

If the graph is simple and you do not need thematic separation, a single Column called "General" is enough.

Fields

Form

FieldWhat it is for
NameName of the column. It is shown in the bottom header of the atlas. Required.
DescriptionDescription of the column. Only visible in the information panel when you click.
ColourBackground colour of the column header. It helps to tell different columns apart visually.
White backgroundIf enabled, the content area of the column has a white background. Useful for columns with a lot of text.
ActiveIf turned off, the column and all its content are hidden from the atlas without being deleted.
📁

Collection

Group of events inside a column, positioned on the time axis

Description

What is it for?

A Collection groups related Points and Phases under a common theme or period within a column. If it has dates, it is positioned automatically on the atlas time axis. Without dates, it appears off the axis as a free list.

Example: in the Politics column, a Collection "Reign of Charles I" with start year 1516 and end year 1556 groups all the political events of that period.

Fields

Form

FieldWhat it is for
NameName of the collection. It is shown as the block header in the atlas. Required.
ColumnThe column this Collection belongs to. Required.
DescriptionDescription of the set of events. Visible in the side panel when you click.
Start yearStart year of the time range. It can be negative for BC periods. If left empty, the Collection floats outside the chronological axis.
End yearEnd year of the range.
ColourBackground colour of this Collection's header in the atlas.
PositionInner position: if two Collections overlap in time within the same column, assign different values (1, 2, 3…) so that they appear in parallel lanes without overlapping.
ImportanceVisual importance. See the importance system.
ActiveIf turned off, the Collection and its Points are hidden without being deleted.
⏱️

Phase

Coloured time span that marks a significant period

Description

What is it for?

A Phase appears as a coloured band in the atlas covering the time range between the start year and the end year. It is used to visualise important periods: reigns, wars, geological eras, stages of a process.

If it is not assigned to any column, the Phase appears on the global axis of the graph, visible from all columns as a common reference.

Fields

Form

FieldWhat it is for
NameName of the period. It is shown rotated vertically inside the band. Required.
DescriptionDescription of the period. Visible in the side panel when you click.
ColumnColumn where the phase appears. If left empty, it appears on the global axis of the graph as a reference for all columns.
Start yearStart year of the phase. Required.
End yearEnd year of the phase. Required.
PositionInner position: if two phases overlap in time within the same column, assign different values (1, 2…) so that they appear in adjacent lanes without overlapping. Required.
ColourBackground colour of the band. Required.
ImportanceVisual importance. See the importance system.
ActiveIf turned off, the phase is hidden without being deleted.
📍

Point

The basic unit of data: a specific event, person, place or fact

Description

What is it for?

The Point is the atom of information in the graph. It can represent a historical event, a person, a place, a work, a battle. It lives inside a Collection and appears in the atlas positioned according to its year.

The same Point can be present in all three views: in the atlas as a label, on the map as a marker (if it has a geolocation) and in the family tree as a node (if it has family relationships assigned).

Fields

Form

FieldWhat it is for
CollectionThe Collection it belongs to. Required.
NameFull name of the event or person. It is shown as a label in the atlas. Required.
Short nameAbbreviated name, for when space in the atlas is limited or in large-text mode.
Short descriptionBrief summary. It is shown in the tooltip on hover and in the information panel as an introduction.
TypeType of the element (person, event, place, etc.). The available types are defined by the graph administrator. Required.
Exact yearFor one-off events (a battle, a birth, a decree). It can be negative. Use this field or the start year / end year pair, not both at once.
Start yearStart year of the range. For events with a duration (a reign, a war, a person's life).
End yearEnd year of the range. It can be left empty if the end is unknown.
ImportanceVisual importance. See the importance system. Required.
TagsTags to classify and filter events.
ActiveIf turned off, the Point is hidden in all views without being deleted.
ℹ️

Geolocation: it is assigned from the Map view, not from this form. After creating the Point, go to the map, turn on edit mode and use the "Add point" button to find it and place it.

ℹ️

Family relationships: they are assigned from the family tree view, not from this form. First create the Point, then go to the tree and use the side panel to connect it with others.

📝

Note

Rich-text notes linked to any element

Description

What is it for?

A Note is a rich-text document attached to an element (Collection, Phase or Point). It lets you add detailed context, analysis, transcriptions or quotations without overloading the main element. The notes of an element appear in the right-hand side panel when you click on it.

Fields

Form

FieldWhat it is for
TitleTitle of the note. If left empty, "Untitled" is shown.
ContentMain body. A text editor with support for bold, italics, lists, tables, images and headings.
Bibliographic referencesSources that support this note. Search by title or author in the search box and add the exact page (e.g. 234-250) or timestamp (e.g. 1:23) the information comes from. The source must exist in the graph's Bibliography, or you can create it directly from here.
External linksComplementary external URLs. Each link has a name, a URL and an optional description.
TagsTags to classify the note.
✅

How to add a note: click an element in the atlas (Point, Collection or Phase) to open the right-hand side panel. Press the "Note" button that appears at the bottom of the panel.

public

Map

🗺️

Map

Cartographic view of the Points and geographic areas

Description

What does it show?

The map view shows, on OpenStreetMap, all the Points that have a geolocation assigned (markers) and the Areas (area polygons). All the content can be filtered by year: enter a year in the side panel and only the elements whose time range includes it will be shown.

There can also be free markers: markers on the map that are not linked to any Point, with their own name and colour. Useful for geographic reference points.

Map side panel

SectionWhat it is for
Map (selector)Lets you switch between different saved map configurations. Each configuration can show a subset of elements. In edit mode you can create and manage configurations.
Year (filter)Enter a year to filter the markers and areas: only the elements whose time range includes that year appear.
AreasLists the active area polygons. In edit mode the + button appears to create a new area by drawing on the map.
Free markersLists the active free markers. In edit mode the + button appears to place a new marker by clicking on the map.

How to geolocate a Point

Turn on edit mode and open the Map view.
Press the Add point button (add_location) in the top menu or the + in the Areas section of the panel.
Search for the Point by name in the side panel's search box.
Click the place on the map where you want to put it. A confirmation form appears with the (optional) years for the time filter.
Press Save. The marker appears on the map and the Point is now geolocated.
✅

Clicking a marker on the map opens the Point's information panel (the same panel as in the atlas), with its description, notes and related elements.

📍

Free markers

Points on the map not linked to any Point of the graph

Description

What are they for?

A free marker is an independent geographic point: it does not represent any Point of the graph but a reference place — a city, an archaeological site, a port, a battlefield — that you want to place on the map without having to create a Point for it.

Like geolocated Points, free markers support a time filter: you can enter an exact year or a range so that the marker only appears on the map when the year filter includes it.

Free markers belong to the graph (unlike Areas, which are shared across all of the user's graphs).

How to create a free marker

Turn on edit mode and open the Map view.
Press the Add point button (add_location) in the top menu or the + in the Free markers section of the side panel.
Click the place on the map where you want to put the marker. The form opens in the side panel.
Fill in the name, the colour and, optionally, the range of years for the time filter.
Press Save. The marker appears on the map and is listed in the Free markers section of the panel.
Fields

Form

FieldWhat it is for
NameName of the geographic point. It is shown in the tooltip on hover. Required.
DescriptionFree text with additional information about the place. Visible when you click the marker.
ColourColour of the marker on the map. Red by default.
Exact yearTo tie the marker to a single moment. Use this field or the start year / end year pair, not both.
Start yearYear from which the marker is visible with the time filter.
End yearYear until which the marker is visible.
CollectionLinks the marker to a Collection of the graph. Optional, used to group it by theme.
ℹ️

Free marker vs. geolocated Point: if the point has an identity of its own in the atlas (a character, an event), create a Point and geolocate it. If it is just a geographic reference point with no content in the atlas, use a free marker.

🗾

Map areas

Geographic polygon drawn on the map to delimit regions

Description

What is it for?

An Area is a polygon drawn on the map that delimits a region: a kingdom, a province, a conflict zone, a route. It can be filtered by year just like markers, so that an area only appears in a given historical period.

Areas are shared across all graphs of the same user. If you have already drawn the medieval kingdoms for one graph, you can reuse them in another without drawing them again.

How to create an Area

Turn on edit mode and open the Map view.
Press the Create area button (format_shapes) in the top menu or the + in the Areas section of the side panel.
Click on the map to place the vertices of the polygon. Close the polygon by double-clicking the last point or by clicking the first one.
Fill in the form in the side panel: name, colour and, optionally, a range of years for the time filter.
Press Save.
Fields

Form

FieldWhat it is for
NameName of the area. It is shown as a floating label over the polygon on the map. Required.
ColourBorder and fill colour of the polygon.
OpacityFill opacity. 0.0 = transparent, 1.0 = solid. 0.3 by default so that it does not cover the markers.
Start yearYear from which the area is visible with the time filter. If left empty, the area is always visible.
End yearYear until which the area is visible.
CollectionLinks the Area to a specific Collection. Optional, used to organise them by theme.
account_tree

Family tree

🌳

Family tree

Visualisation of kinship networks and family relationships

Description

What does it show?

The family tree view represents the Points of the graph as nodes connected by kinship lines. The tree is generated dynamically from the relationships you have defined between Points: spouse, son, daughter, brother, sister.

It can be filtered by year: enter a year in the filter field and only the people whose lifespan includes that year will appear.

Tree side panel

SectionWhat it is for
Year (filter)Filters the tree by year of life: only the Points whose time range includes that year are shown.
RelationshipsIn edit mode, selecting a node in the tree shows the list of its current relationships and the form to add new ones.

How to add a person to the tree

Turn on edit mode and open the Family tree view.
Press the Add person button (person_add) in the top menu to show the search box.
Search for the Point by name. Click the result to add it to the tree as a node.
Click the node on the canvas to select it. The side panel appears with its current relationships.
Use the panel's search box to find the other person, select the relationship type and press Save.
Relationship types
TypeMeaning
SpouseMarriage or partnership. The relationship is bidirectional: when you add it in one direction it is recorded on both nodes.
Son / DaughterDescendant. The node appears one level below the parent in the tree. The gender is indicated when you choose the type.
Brother / SisterLateral relationship between nodes of the same generation. The gender is indicated when you choose the type.
💡

For a clear genealogy, start with the oldest people (grandparents, great-grandparents) and connect from top to bottom. The tree automatically calculates the generational position of each node.

menu_book

Bibliography

📚

Bibliography

Reference sources linked to the graph's notes

Description

What is it for?

The Bibliography is the repository of sources for the graph: books, articles, websites, documentaries and podcasts. Each source can be linked to one or several Notes, indicating the exact page or timestamp the information comes from.

Sources are created once and reused in all the notes of the graph that need them. When you open a Note you see the cited sources with the corresponding page number or timestamp.

Book

Fields

FieldWhat it is for
TitleTitle of the book. Required.
AuthorName of the author or authors.
PublisherPublisher that published the book.
YearYear of publication.
ISBNISBN code to identify the exact edition.
DescriptionBrief summary of the content or of the topic relevant to the graph.
Journal / Article

Fields

FieldWhat it is for
TitleTitle of the article. Required.
AuthorName of the author or authors.
JournalName of the publication or journal where the article appears.
YearYear of publication.
Volume / IssueVolume number and issue of the journal.
PagesPage range of the article within the publication. E.g. 45–62.
URLLink, if a digital version or a version in an academic repository exists.
DescriptionBrief summary of the relevant content.
Web

Fields

FieldWhat it is for
TitleTitle of the web page or article. Required.
URLFull web address. Required.
Author / OrganisationPerson or body responsible for the content, if known.
YearYear of publication or of the last update.
Access dateDate on which you accessed the content. Useful for pages that may change.
DescriptionBrief description of the content of the page.
Video / Documentary

Fields

FieldWhat it is for
TitleTitle of the video or documentary. Required.
Channel / DirectorName of the YouTube channel, the director of the documentary or the production company.
PlatformWhere it is available: YouTube, Vimeo, Netflix, Prime Video, BBC iPlayer…
YearYear of publication or release.
DurationTotal duration. E.g. 1h 32min.
URLDirect link to the video or the documentary's page.
DescriptionBrief description of the content relevant to the graph.
Podcast

Fields

FieldWhat it is for
TitleTitle of the episode. Required.
PodcastName of the podcast programme or series.
Host / ChannelName of the host or of the channel that publishes it.
YearYear the episode was published.
Episode no.Season and episode number. E.g. S2 E14.
DurationTotal duration of the episode.
URLLink to the episode on Spotify, iVoox, Apple Podcasts or another platform.
DescriptionBrief description of the topic covered in the episode.
✅

How to cite in a note: from the Note form, use the "Bibliographic references" search box to find the source, add the page number (e.g. 234–250) or timestamp (e.g. 1:23) and save. The reference is linked to that note.

cloud_upload

Importer

☁️

Smart importer

Creates graph elements from a web page, a video or a document

Description

What is it for?

The importer reads an external source, extracts Collections, Phases, Points, Notes and bibliographic references from it and presents them to you as a proposal. Nothing is saved to the graph until you review the proposal and accept it.

It is opened from the more_horiz menu → Import (cloud_upload), and is only available in edit mode.

Sources

What you can import

  • A URL: web page, YouTube video, DOI, arXiv or RSS feed.
  • A file: PDF or EPUB (up to 25 MB).
Configuration

Options before importing

OptionWhat it is for
DepthShallow: only collections and main points. Medium: collections, phases, points and notes; genealogy and map if the content calls for it. Deep: everything, including detailed notes, genealogy, all map points and chains of links.
Follow linksIn addition to the source you specify, it follows the links it contains to expand the information.
Check for duplicatesWarns you when a proposed element may already exist in the graph.
What to createTick which types of element you want to generate: Collections, Phases, Notes, Bibliography, Genealogy and Map.
Workflow

How to use it

Turn on edit mode and open Import from the more_horiz menu.
Enter the URL or upload a file, adjust the configuration if you need to and press Import.
Wait for the processing to finish: one import is processed at a time and the list of Proposals updates itself. If a URL was already imported before, you will be asked whether you want to import it again.
Select the proposal, review the elements and untick the ones you do not want. For new Collections, choose the Target column.
Press Accept and save to create the elements, or Reject to discard the proposal.
✅

Correcting a proposal: use the Chat with Claude inside the proposal to ask for changes (for example, “merge these two phases” or “remove the notes about X”) before accepting it. If an import fails or is left incomplete, you can Retry it.

ℹ️

The importer uses an artificial intelligence API with a monthly usage limit per user. If you exceed it, you will see a limit-exceeded notice and will not be able to import until the following month. Always review the proposals: they may contain mistakes or elements you already have.

map

Guides

🚀

Basic workflow from scratch

The minimum order to get visible content in the graph

Create the Graph. Define the name and the type (absolute / relative) and enable the views you need. The type cannot be changed after adding content.
Create at least one Column. If you do not need thematic separation, name it "General". Turn on edit mode and use the view_column_2 icon in the menu.
Create a Collection inside the Column. Give it a name and, if the graph is of the absolute type, define the start and end year to position it on the axis.
Optionally, create Phases to mark important periods with coloured bands.
Create Points inside the Collection. Each one needs a name, a collection, a type and at least one date field.
Click a Point in the atlas to open the side panel and add notes and Bibliography references.
🏛️

Example: medieval history

Structure for a history graph

Graph: "History of Castile" — absolute type
Column: "Politics"
Collection: "Crown of Castile" start year 1065 – end year 1504
Phase: "Reign of Ferdinand III" 1217–1252, position 1
Phase: "Reconquista" 722–1492, position 2
Point: "Battle of Las Navas de Tolosa" exact year: 1212, importance: 2
Column: "Culture"
Collection: "Medieval literature" 12th – 15th c.
Column: "Religion"
🌳

Example: family tree

Structure for a family genealogy graph

Graph: "The García family" — absolute type + family tree enabled
Point: "Juan García" 1920–1985 · spouse of María
Point: "María López" 1923–2001 · spouse of Juan
Point: "Pedro García" 1950– · son of Juan and María
ℹ️

Points are created from the atlas (they need at least one Column and one Collection). Once created, go to the Family tree view, add each person to the tree and use the side panel to connect them with the relationship types.