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
Atlas
Main view. Thematic columns, time spans and events along a chronological axis.
Map
Geolocated events and areas on OpenStreetMap. Filterable by year.
Family tree
People connected by family relationships. Filterable by year of life.
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
HistoricalThe 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 datesThe 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.
New graph form
| Field | What it is for |
|---|---|
| Name | Name of the project. It appears in the header and in the list of graphs. Required. |
| Description | Description of the project. Useful for stating its scope or theme. |
| Type | Absolute or Relative, as explained above. Required. It cannot be changed afterwards. |
| Public | If enabled, anyone with the link can view the graph without signing in. It is private by default. |
| Active views | In 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 text | Increases the text size of the atlas elements to improve legibility on large screens or projectors. |
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
| Element | How it appears |
|---|---|
| Column | Column header at the bottom of the screen, with the configured name and colour. Columns can be reordered with the arrow buttons in edit mode. |
| Collection | A 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. |
| Phase | A 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. |
| Point | A 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
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.
| 0 | Always visible, regardless of zoom |
| 1 | Very important — visible from the most distant view |
| 2 | Important |
| 3 | Normal — recommended default value |
| 4 | Detail — only visible when zoomed in |
| 5 | Very 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
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.
Form
| Field | What it is for |
|---|---|
| Name | Name of the column. It is shown in the bottom header of the atlas. Required. |
| Description | Description of the column. Only visible in the information panel when you click. |
| Colour | Background colour of the column header. It helps to tell different columns apart visually. |
| White background | If enabled, the content area of the column has a white background. Useful for columns with a lot of text. |
| Active | If 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
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.
Form
| Field | What it is for |
|---|---|
| Name | Name of the collection. It is shown as the block header in the atlas. Required. |
| Column | The column this Collection belongs to. Required. |
| Description | Description of the set of events. Visible in the side panel when you click. |
| Start year | Start year of the time range. It can be negative for BC periods. If left empty, the Collection floats outside the chronological axis. |
| End year | End year of the range. |
| Colour | Background colour of this Collection's header in the atlas. |
| Position | Inner 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. |
| Importance | Visual importance. See the importance system. |
| Active | If turned off, the Collection and its Points are hidden without being deleted. |
Phase
Coloured time span that marks a significant period
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.
Form
| Field | What it is for |
|---|---|
| Name | Name of the period. It is shown rotated vertically inside the band. Required. |
| Description | Description of the period. Visible in the side panel when you click. |
| Column | Column where the phase appears. If left empty, it appears on the global axis of the graph as a reference for all columns. |
| Start year | Start year of the phase. Required. |
| End year | End year of the phase. Required. |
| Position | Inner 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. |
| Colour | Background colour of the band. Required. |
| Importance | Visual importance. See the importance system. |
| Active | If turned off, the phase is hidden without being deleted. |
Point
The basic unit of data: a specific event, person, place or fact
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).
Form
| Field | What it is for |
|---|---|
| Collection | The Collection it belongs to. Required. |
| Name | Full name of the event or person. It is shown as a label in the atlas. Required. |
| Short name | Abbreviated name, for when space in the atlas is limited or in large-text mode. |
| Short description | Brief summary. It is shown in the tooltip on hover and in the information panel as an introduction. |
| Type | Type of the element (person, event, place, etc.). The available types are defined by the graph administrator. Required. |
| Exact year | For 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 year | Start year of the range. For events with a duration (a reign, a war, a person's life). |
| End year | End year of the range. It can be left empty if the end is unknown. |
| Importance | Visual importance. See the importance system. Required. |
| Tags | Tags to classify and filter events. |
| Active | If 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
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.
Form
| Field | What it is for |
|---|---|
| Title | Title of the note. If left empty, "Untitled" is shown. |
| Content | Main body. A text editor with support for bold, italics, lists, tables, images and headings. |
| Bibliographic references | Sources 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 links | Complementary external URLs. Each link has a name, a URL and an optional description. |
| Tags | Tags 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.
Map
Map
Cartographic view of the Points and geographic areas
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
| Section | What 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. |
| Areas | Lists the active area polygons. In edit mode the + button appears to create a new area by drawing on the map. |
| Free markers | Lists 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
+ in the Areas section of the panel.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
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
+ in the Free markers section of the side panel.Form
| Field | What it is for |
|---|---|
| Name | Name of the geographic point. It is shown in the tooltip on hover. Required. |
| Description | Free text with additional information about the place. Visible when you click the marker. |
| Colour | Colour of the marker on the map. Red by default. |
| Exact year | To tie the marker to a single moment. Use this field or the start year / end year pair, not both. |
| Start year | Year from which the marker is visible with the time filter. |
| End year | Year until which the marker is visible. |
| Collection | Links 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
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
+ in the Areas section of the side panel.Form
| Field | What it is for |
|---|---|
| Name | Name of the area. It is shown as a floating label over the polygon on the map. Required. |
| Colour | Border and fill colour of the polygon. |
| Opacity | Fill opacity. 0.0 = transparent, 1.0 = solid. 0.3 by default so that it does not cover the markers. |
| Start year | Year from which the area is visible with the time filter. If left empty, the area is always visible. |
| End year | Year until which the area is visible. |
| Collection | Links the Area to a specific Collection. Optional, used to organise them by theme. |
Family tree
Family tree
Visualisation of kinship networks and family relationships
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
| Section | What it is for |
|---|---|
| Year (filter) | Filters the tree by year of life: only the Points whose time range includes that year are shown. |
| Relationships | In 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
| Type | Meaning |
|---|---|
| Spouse | Marriage or partnership. The relationship is bidirectional: when you add it in one direction it is recorded on both nodes. |
| Son / Daughter | Descendant. The node appears one level below the parent in the tree. The gender is indicated when you choose the type. |
| Brother / Sister | Lateral 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.
Bibliography
Bibliography
Reference sources linked to the graph's notes
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.
Fields
| Field | What it is for |
|---|---|
| Title | Title of the book. Required. |
| Author | Name of the author or authors. |
| Publisher | Publisher that published the book. |
| Year | Year of publication. |
| ISBN | ISBN code to identify the exact edition. |
| Description | Brief summary of the content or of the topic relevant to the graph. |
Fields
| Field | What it is for |
|---|---|
| Title | Title of the article. Required. |
| Author | Name of the author or authors. |
| Journal | Name of the publication or journal where the article appears. |
| Year | Year of publication. |
| Volume / Issue | Volume number and issue of the journal. |
| Pages | Page range of the article within the publication. E.g. 45–62. |
| URL | Link, if a digital version or a version in an academic repository exists. |
| Description | Brief summary of the relevant content. |
Fields
| Field | What it is for |
|---|---|
| Title | Title of the web page or article. Required. |
| URL | Full web address. Required. |
| Author / Organisation | Person or body responsible for the content, if known. |
| Year | Year of publication or of the last update. |
| Access date | Date on which you accessed the content. Useful for pages that may change. |
| Description | Brief description of the content of the page. |
Fields
| Field | What it is for |
|---|---|
| Title | Title of the video or documentary. Required. |
| Channel / Director | Name of the YouTube channel, the director of the documentary or the production company. |
| Platform | Where it is available: YouTube, Vimeo, Netflix, Prime Video, BBC iPlayer… |
| Year | Year of publication or release. |
| Duration | Total duration. E.g. 1h 32min. |
| URL | Direct link to the video or the documentary's page. |
| Description | Brief description of the content relevant to the graph. |
Fields
| Field | What it is for |
|---|---|
| Title | Title of the episode. Required. |
| Podcast | Name of the podcast programme or series. |
| Host / Channel | Name of the host or of the channel that publishes it. |
| Year | Year the episode was published. |
| Episode no. | Season and episode number. E.g. S2 E14. |
| Duration | Total duration of the episode. |
| URL | Link to the episode on Spotify, iVoox, Apple Podcasts or another platform. |
| Description | Brief 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.
Importer
Smart importer
Creates graph elements from a web page, a video or a document
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.
What you can import
- A URL: web page, YouTube video, DOI, arXiv or RSS feed.
- A file: PDF or EPUB (up to 25 MB).
Options before importing
| Option | What it is for |
|---|---|
| Depth | Shallow: 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 links | In addition to the source you specify, it follows the links it contains to expand the information. |
| Check for duplicates | Warns you when a proposed element may already exist in the graph. |
| What to create | Tick which types of element you want to generate: Collections, Phases, Notes, Bibliography, Genealogy and Map. |
How to use it
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.
Guides
Basic workflow from scratch
The minimum order to get visible content in the graph
Example: medieval history
Structure for a history graph
Example: family tree
Structure for a family genealogy graph
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.