How tapilab/ant works
ANT is a Django web application for creating and exploring humanities network visualizations from spreadsheet data. A site owner submits a Google Sheet URL; the configuration view enqueues an import, which reads the sheet, builds entity and relationship records, and stores a serialized network for the interactive network page. Visitors can also browse entities and details, while site owners can configure branding and manage a single account. The README documents keyword, time, and entity-type exploration; the supplied excerpts do not expose the visualization’s client-side filtering implementation, so that capability is represented at the page level.
Main entry points: views.py Page views · util.py Sheet importer · models.py Entity records · urls.py HTTP routes
Components 19
Web experience
- HTTP routes
ant/urls.py - Page views
core/views.py - Rendered pages
core/templates - Entity options
core/context_processors.py - Network explorer
core/templates/network.html - Entity pages
core/templates/entity.html
Data import
- Sheet configuration
core/forms.py - Sheet importer
core/util.py - Google Sheets
- RQ queue
- Background task stub
core/tasks.py
Network domain
- Entity records
core/models.py - Relationship records
core/models.py - Serialized network
core/models.py - Application database
Site management
- Input forms
core/forms.py - Accounts and branding
core/models.py
Other components
- Visitor
- Site owner
Connections 23
- Visitor → HTTP routes: requests pages
ant/urls.py - Site owner → HTTP routes: opens configuration
ant/urls.py - HTTP routes → Page views: routes requests
ant/urls.py - Page views → Rendered pages: renders pages
core/views.py - Page views → Input forms: validates submissions
core/views.py - Page views → Accounts and branding: reads branding
core/views.py - Entity options → Entity records: queries entity types
core/context_processors.py - Page views → Entity records: queries entities
core/views.py - Page views → Relationship records: queries relationships
core/views.py - Page views → RQ queue: enqueues import
core/views.py - RQ queue → Sheet importer: runs import
- Sheet importer → Google Sheets: reads workbook
core/util.py - Sheet importer → Entity records: creates records
core/util.py - Sheet importer → Relationship records: creates links
core/util.py - Sheet importer → Serialized network: stores JSON
core/util.py - Page views → Serialized network: loads network
core/views.py - Serialized network → Application database: persists records
- Entity records → Application database: persists records
- Relationship records → Application database: persists records
- Accounts and branding → Application database: persists records
- Page views → Network explorer: renders explorer
core/views.py - Page views → Entity pages: renders details
core/views.py - Input forms → Accounts and branding: saves profile
core/forms.py