LogoLogo
  • About DS Learn
  • Tutorials
    • ¶ Digital Exhibits
      • Getting Started with Digital Exhibits
        • Considerations
        • Basic Steps
          • Site Organization
          • Usability & Accessibility
        • Platforms
    • ¶ Digital Storytelling
      • Introduction to ArcGIS StoryMaps
        • Getting Started
        • Using Content Blocks
        • Importing Maps from David Rumsey
      • Introduction to KnightLab StoryMap JS
      • TimelineJS
    • ¶ 3D Modeling & Immersive Technology
      • Adding 3D Models in Omeka
      • Intro to Photo Processing with Agisoft Metashape for 3D Model Making
      • Tips and Tricks for Taking Photos for 3D Model Creation
      • An Introduction to Apple's Reality Composer AR
      • Importing SketchFab Models into AR for the iPad or iPhone
      • Creating Basic 3D Objects for AR in Blender
      • Introduction to Meshlab
    • ¶ Data Visualization
      • Introduction to Tableau
        • Download and Install Tableau
        • Using Tableau to Visualize COVID-19 Data
        • Tableau DH
        • Resources
      • Beyond Simple Chart in Tableau
        • Beyond Simple chart Examples
      • Google Colab
        • Get Started
        • Data Import
        • Data Wangling
        • Visualization
        • Results Export
      • Out of Box Data Visualization Tools
        • How to use Google Data Studio with Google Sheets
        • Google Data Studio Interface
        • Creating Visualizations in Google Data Studio
    • ¶ Mapping
      • Tiling High-Resolution Images for Knightlab StoryMapJS
      • Hosting and Displaying Zoomable Images on Your Webpage
      • Georectifying Historical Maps using MapWarper
      • Making a Starter Map using Leaflet
    • ¶ REST API
      • How does REST API work?
      • JSON File
      • Get Started with Google Sheets Script Editor
      • Example 1: Extract Data by One Cell
      • Example 2: Extract Data by A Cell Range
    • ¶ Text Analysis
      • Introduction to Text Analysis
        • Step 1: Exercise One
        • Step 2: What is Text Analysis?
        • Step 3: Important Considerations
        • Step 4: Why Voyant and Lexos?
        • Step 5: Exercise Two
      • Text Repositories
      • Text Analysis in JSTOR
        • Overview of Constellate
        • Build A Dataset
        • Create A Stopwords List
        • Word Frequency
  • Digital Scholarship Incubator
    • Schedule
    • Getting Started
    • People
    • Project Guidelines
    • Topics
      • 3D Modeling and Immersive Technologies
        • Part 1: 3D Photogrammetry & Laser Scanning
          • Exercise: Experiment with 3D creation tools
        • Part 2: An Introduction to Apple's Reality Composer AR
          • Exercise: Experiment with Apple RealityComposer AR
      • Anatomy of a DS Project
        • Parts of a DS Project
        • Some DS Project Examples
        • Exercise: Evaluating a DS Project
      • Pedagogy
      • Data and Data Visualization
        • Introduction to Data
        • Introduction to Data Visualization
        • Introduction to Tableau
          • Download and Install Tableau
        • Introduction to Network Visualization
      • Digital Exhibits
        • Exercise 1: Exploring Exhibits
        • Exercise 2: Exhibit.so
      • DS Intro & Methodologies
      • User Experience
        • Usability Exercise
      • Mapping and GIS
        • An Introduction to Mapping, GIS and Vector Data
          • Workshop: Exploring and Creating Vector Data
          • Quick Review: Spatial Data
        • An Introduction to Raster Data and Georeferencing Historical Maps
          • Workshop: Finding and Georeferencing an Historical Map
          • Tutorial: Georectifying Historical Maps using MapWarper
        • Presentation + Workshop: Putting it together in ArcGIS Online
        • Workshop: A Brief Introduction to QGIS
          • Adding Base-maps and Raster Data
          • Adding and Creating Basic Vector Data
          • Styling your data and preparing it for exporting
      • Story Maps
        • Story Map Exercise
      • Text Analysis
        • Exercise 1: Voyant
        • Exercise 2: Python
Powered by GitBook
On this page
  • Install Necessary Plugins
  • Preparing Models for Omeka
  • Uploading your Model to Omeka

Was this helpful?

Export as PDF
  1. Tutorials
  2. ¶ 3D Modeling & Immersive Technology

Adding 3D Models in Omeka

Previous¶ 3D Modeling & Immersive TechnologyNextIntro to Photo Processing with Agisoft Metashape for 3D Model Making

Last updated 2 years ago

Was this helpful?

With the use of a couple of plugins, both Omeka S and Omeka Classic allow you to incorporate 3D models into your digital exhibits. Getting both your site and the 3D models in the proper form, however, takes a bit of work, particularly for Omeka S.

Install Necessary Plugins

While both Omeka S and Omeka Classic display 3D models using the Universal Viewer plugin, there are a few others that are necessary to ensure the framework is properly set up.

Plugins/Modules to Install in both Omeka S and Omeka Classic

  • Universal Viewer - This is the actual viewer that can display both 3D models and normal images/pdfs/etc. Its design is much nicer than the standard Omeka presentation view.

  • Archive Repertory - Keeps original names of imported files and puts them in a hierarchical structure (collection/item/files) in order to get readable URLs for files and to avoid overloading the file server.

Additional Modules for Omeka S

  • IIIF Server: Integrates the IIIF specifications to allow you to share instantly images, audio, and video.

  • Image Server: A simple and IIIF-compliant image server to process and share instantly images of any size in the desired formats.

As of the writing of these instructions, installing the Image Server module required the ability to directly access and install the module on the server, rather than copying the filer over using the FTP/SSH and installing from the Omeka Module page.

Preparing Models for Omeka

To display 3D models, we use the Universal Viewer plugin, which uses the ThreeJS library to display the models. This means that the model needs to be in a .json format to upload the file to Omeka. There are a variety of ways to do this, but an easy method is to use the .

  1. Open the ThreeJS Editor Link.

  2. Upload your 3D model (OBJ, gltf, etc.) by going to File --> Import and navigating to your 3D file.

  3. The mesh (geometry) of your model will appear. The next step is to attach the texture (color overlay) to the model, if it is not already integrated into your file. To do this, click the "+" next to the name of your file on the top of the right sidebar and select the material associated with it (generally "material_0"). Then choose the "Material" tab below.

  4. From here, where it says "Type," select "MESHBASICMATERIAL," which should be at the top of the list of choices. Next, click the dark rectangle next to "Map" a bit further down the sidebar, and navigate to your texture (usually a .jpg, if you are uploading an obj). Finally, check the small box next to "Map" and the texture should appear.

  5. Your model should look good now! The last step in the editor is to go to File--> Export Scene, and the model should be exported as a .json to your downloads folder.

Uploading your Model to Omeka

Your model is now in the correct format (.json) to be uploaded to Omeka. In each case, you will want to be sure that JSON extension and the application/JSON file type are allowed (in Omeka Classic, go to Settings--> Security from the top of the Admin dashboard; in Omeka S, go to Settings in the Admin sidebar and scroll down to the Security section).

Now just create a new Item as you would any other item in Omeka, with the .json file as your main file upload! Note that if you want a proper thumbnail in Omeka Classic, you should upload two files for your item, first a normal jpg of the thumbnail you want to use, and then the .json file of your 3D model. In Omeka S, there is an option when creating your item for adding a thumbnail image if you wish.

ThreeJS editor
ThreeJS Editor Options
Our model inside the Universal Viewer in Omeka S