Atlas Collection Data Structure - KolderTech/aodtdoc GitHub Wiki
The Atlas Collection holds two different types of data:
- Files - are uploaded files that administrators can put into the system for use by Assets. An uploaded file creates a new asset within the database system. It also provides a unique URL that can be used to reference the file object from within any asset or on the Internet. For example administrators upload photos, 3d objects, and maps as files into the system.
- Assets - are individual records that have tags and values and can link to files and URLs. Assets are the records that the Atlas Web Site uses to find data within the Atlas system. Assets are organized into document types. By default an uploaded file is attached to an asset of document type file.
Document Types
The Collection organizes Assets into specific document types. The following collection document types are currently supported by the system:
Geography
| Document Type | Internal Name | Archive Visible | Map visible | Description |
|---|---|---|---|---|
| Locale | locale | no | yes | used to define Regions, Basins, Projects, and Places. |
| Dams | dams | no | yes | an asset record for a tracked dam in the system. |
| Towns | towns | no | yes | an asset record for a tracked town in the system. |
Artifacts
| Document Type | Internal Name | Archive Visible | Map visible | Description |
|---|---|---|---|---|
| Photo | photo | yes | yes | an asset associated with a file in the system. |
| News | news | yes | yes | an asset record for tracking newspaper articles to make available on the Atlas web site. |
| Threedart | threedart | yes | yes | an asset record for tracking a 3D object for display on the Atlas web site. |
| Oral | oral | yes | yes | an asset for tracking details of a historical oral statement. |
| Official | official | yes | yes | an asset record for tracking details related to official records. |
| Personal | personal | yes | yes | an asset record for tracking details about a personal object provided by someone. |
| Birdseye | birdseye | yes | yes | birdseye images available for viewing on the web site. |
| Aerial | aerial | yes | yes | aerial photographs that are georeferenced and visible as overlays on the Atlas Web Site. |
| Maps | maps | yes | yes | historical georeferenced maps that are visible on the Atlas Web Site. |
Stories and Articles
| Document Type | Internal Name | Archive Visible | Map visible | Description |
|---|---|---|---|---|
| Narrative | narrative | no | yes | an asset associated with a written historical narrative provided by a Historian affiliated with the Atlas of Drowned Towns project. |
| Community | community | no | yes | an asset associated with a story provided by the community. |
Internal
| Document Type | Internal Name | Archive Visible | Map visible | Description |
|---|---|---|---|---|
| File | file | no | no | an asset simply associated with an uploaded file in the Atlas system. |
| Deleted | deleted | no | no | an asset marked for removal from the system. |
| Missing | missing | no | no | an asset with no designated document type. |
The following document types are not directly visible on the Atlas Web Site:
missing, file, locale, and deleted.
For each document type define the tags, and also the attached configuration components for each record.
Defined Meta Data Schema for all Document Types
Below is the Atlas of Drowned Towns meta data schema for all document types.
| Document Type | System Name | User Visible | Required Tags | Tombstone Tags |
|---|---|---|---|---|
| Missing | missing | No | no tags | No tombstone |
| File | file | No | URI | No tombstone |
| Dam | dams | Yes | atlasname, longitude, latitude, region, project, place | name, agency, year, construction, cost, size, power, storage, purpose |
| Towns | towns | Yes | atlasname, longitude, latitude, region, project, place | name, year, established, inundated, population, dam, river |
| Photo | photo | Yes | atlasname, longitude, latitude, region, project, place, uri | name, caption, year, photographer, sources, approximate |
| News | news | Yes | atlasname, longitude, latitude, region, project, place, uri | name, title, newspaper, year, sources, approximate |
| Threedart | threedart | Yes | atlasname, longitude, latitude, region, project, place, uri | name, year, sources, approximate |
| Oral | oral | Yes | atlasname, longitude, latitude, region, project, place, uri | name, title, date, narrator, interviewer, year, sources, approximate |
| Official | official | Yes | atlasname, longitude, latitude, region, project, place, uri | name, creator, year, sources, approximate |
| Personal | personal | Yes | atlasname, longitude, latitude, region, project, place, uri | name, title, creator, year, sources, approximate |
| Locale | locale | No | atlasname, longitude, latitude, region, project, place, uri | No tombstone |
| Birdseye | birdseye | Yes | atlasname, longitude, latitude, region, project, place, uri | name, caption, year, photographer, sources, approximate |
| Aerial | aerial | Yes* | atlasname, longitude, latitude, region, project, place, uri | No tombstone |
| Maps | maps | Yes* | atlasname, longitude, latitude, region, project, place, uri | No tombstone |
| Narrative | narrative | Yes* | atlasname, longitude, latitude, region, project, place, uri | No tombstone |
| Community | community | Yes* | atlasname, longitude, latitude, region, project, place, uri | No tombstone |
| Deleted | deleted | No | no tags | No tombstone |