Skip to main content

​
Description

Reference objects allow users to upload data directly into their Davinci system model. This is useful for keeping all data sources in one location, and for access by the agent. When the agent uses reference objects to generate or modify other model objects, it will create reference relationships between the reference object. This relationship will describe where in the reference object it found the information that it used. Files can be uploaded and added as Reference Objects to the model by dragging and dropping the file into Davinci when a project is open, or by uploading with the upload button in the Library Index header. The files that Reference objects contain can be managed inside Project Settings.

​
Importing Files

Reference objects support importing various file types, making it easy to integrate existing documentation, data, and media into your Davinci model.

​
Supported File Types

Documents:
  • PDF files - Technical specifications, datasheets, research papers
    Word (DOCX) and Excel spreadsheets (XLSX) all will be converted automatically into Davinci documents and tables.
Images:
  • PNG, JPG, JPEG - Photographs, screenshots, diagrams
  • GIF - Animated graphics, simple diagrams
  • WebP - Modern compressed images
Arbitrary Files:
  • Any file type can be uploaded for storage and agent access
  • Non-standard formats stored as-is for reference

​
Import Methods

Drag and Drop:
  1. Open a project in Davinci
  2. Drag files from your file system into the Davinci window
  3. Files are automatically uploaded and Reference objects are created
  4. Multiple files can be dragged simultaneously
Upload Button:
  1. Click the upload button in the Library Index header
  2. Select files from the file browser dialog
  3. Files are uploaded and Reference objects are created
Both methods create Reference objects with appropriate metadata extracted from the file (filename, type, size).

​
Document Conversion and Agent Usage

Automatic Content Extraction: The Davinci agent can read and analyze imported files to extract information:
  • PDF text extraction for datasheets and specifications
  • Image analysis for diagrams and photographs
  • Excel data parsing for tables and datasets
  • Word document text extraction for requirements
Agent-Assisted Model Population: When you ask the agent to extract information from a Reference object, it:
  1. Reads the file content
  2. Analyzes and structures the information
  3. Creates appropriate model objects (requirements, attributes, parts, etc.)
  4. Establishes reference relationships linking new objects back to the source
Example: Upload a component datasheet PDF, then ask the agent to “extract the specifications from @DatasheetReference and create attributes.” The agent creates attribute objects with values from the datasheet and links them to the Reference object.

​
Image Integration

Images imported as Reference objects can be:
  • Inserted into Documents as figures or inline images
  • Added to Slides for presentations
  • Referenced in model object documentation
  • Analyzed by the agent for diagram interpretation
Images are stored efficiently and can be reused throughout the model without duplication.

​
View Types

ViewDescription
ReferenceView the uploaded file content.
PropertiesEdit the object’s properties, attributes, and metadata.
RelationshipsExplore the network of connections to other objects.

​
Properties Fields

​
Name
string
Name of the object.
​
Short Name
string
Short name of the object.
​
Description
string
Description of the object.
​
Relationships
connection
A list of all Relationships this object has with other model objects.Read more about Relationships

​
Citation

​
citation.name
string
The citation name.
​
citation.authors
string
The authors of the reference.
​
citation.title
string
The title of the reference.
​
citation.publication
string
The publication where the reference appeared.
​
citation.volume
string
The volume number of the reference.
​
citation.issue
string
The issue number of the reference.
​
citation.pages
string
The page numbers of the reference.
​
citation.month
string
The month of publication.
​
citation.year
string
The year of publication.
​
citation.doi
string
The Digital Object Identifier (DOI) of the reference.
​
citation.url
string
The URL link to the reference.
​
citation.isbn
string
The International Standard Book Number (ISBN) of the reference.
​
citation.publisher
string
The publisher of the reference.
​
citation.edition
string
The edition of the reference.
If using references in Davinci documents, use the @reference inline in text. Any added bibliography section will use the citation data of the object and rendered a citation list with numbered citations in documents.