Oct 09, 2024

Public workspaceReViBE: protocol for Refit Visualisation of lithic reduction sequences using the Blender Engine

 Forked from ReViBE: protocol for Refit Visualisation of lithic reduction sequences using the Blender Engine
DOI
dx.doi.org/10.17504/protocols.io.kqdg32jrpv25/v1
  • 1CEPAP-UAB - Centre d'Estudis del Patrimoni Arqueòlogic de la Prehistòria, Universitat Autònoma de Barcelona, 08193 Bellaterra, Spain;
  • 2ICArEHB – The interdisciplinary Center for Archaeology and Evolution of Human Behaviour, Universidade do Algarve, Campus de Gambelas, 8005-139 Faro, Portugal;
  • 3CASEs- Culture, Archaeology, and Socio-Ecological Dynamics group. Universitat Pompeu Fabra. Departament d'Humanitats. 08005 Barcelona, Spain.
Xavier Roda Gilabert
Icon indicating open access to content
QR code linking to this content
DOI: dx.doi.org/10.17504/protocols.io.kqdg32jrpv25/v1
Protocol Citation: Javier Sánchez-Martínez, Katia Calmet, Jorge Martínez-Moreno, Xavier Roda Gilabert 2024. ReViBE: protocol for Refit Visualisation of lithic reduction sequences using the Blender Engine. protocols.io https://dx.doi.org/10.17504/protocols.io.kqdg32jrpv25/v1
Manuscript citation:
Sánchez-Martínez J, Calmet, K,  Martínez Moreno J, Roda Gilabert X (submited) Virtual reconstruction of stone tool refitting by using 3D modelling and the Blender Engine: the application of the “ReViBE” protocol to the archaeological record. PLOS ONE
License: This is an open access protocol distributed under the terms of the Creative Commons Attribution License,  which permits unrestricted use, distribution, and reproduction in any medium, provided the original author and source are credited
Protocol status: Working
We use this protocol and it's working
Created: October 09, 2024
Last Modified: October 09, 2024
Protocol Integer ID: 109420
Keywords: material culture, stone tools, lithic refittings, photogrammetry, Blender, 3D modelling
Funders Acknowledgement:
Program for the Requalification of the University System Margarita Salas
Grant ID: CA1/RSUE/2022-889183
Program for the Requalification of the University System Margarita Salas
Grant ID: CA1/RSUE/2021- 707703
Human occupation during the Upper Pleistocene and Holocene in the south-eastern Pyrenees
Grant ID: PID2022-136363NB-I00
National Public Employment Service
Grant ID: NextGenerationEU
Abstract
Here, we introduce ReViBE, a step-by-step protocol for visualising lithic refits through the utilisation of imaging technologies, photogrammetry, 3D modelling and Blender animation software. Lithic refittings represent high-resolution temporal sequences that shed light in cognitive, organisational and taphonomic aspects of the archaeological record, and have remained integral for the archaeological science since its inception. Despite their popularity, little work has been focused on the representation of refittings, traditionally undertaken through photography and archaeological drawing. While the use of these recording tools are widespread in the discipline, their application in refittings has limitations, as they fail to capture the three-dimensional nature of lithic reduction.

Our ReViBE protocol addresses this issue through a step-by-step procedure that combines the creation of 3D models in refittings and their animation, allowing a more dynamic visualization of lithic reduction sequences in high definition. The protocol consists of three main phases in which we explain how to perform photogrammetry on the refitted artifacts, create three-dimensional models from the captured images (e.g., Photoscan/Metashape), and finally, generate animation by reconstructing the motion of each individual piece in a temporal sequence (e.g., Blender).

Furthermore, we suggest incorporating protocols employing 3D modelling to aid in the digital visualization of material culture, enhancing the accessibility and study of archaeological heritage.



Content:

Part 1 – Initial remarks and set up preparation
Part 2 – Obtention of 3D models using photogrammetry
Part 3 – Converting images to 3D
Part 4 – Creation of animation sequences using Blender
Supplementary video






Flowchart showing the workflow when using the ReViBe protocol according to the standardised symbols of ISO 5807:1985 and Myler, 1998.


Image Attribution
All images by Katia Calmet and CEPAP-UAB.
Guidelines
Typographical emphasis used in the protocol:

  • References to materials and software used in italics, e.g. Helicon Focus
  • Software features in bold, e.g. Align Photos
  • Computational workflows linked by angle brackets (>), e.g. Workflow > Build Mesh
  • Keyboard buttons indicated by angle markers (< >), e.g. <Right-Click >

This protocol was developed using Helicon Remote© 4.4.4, Agisoft Photoscan© 1.5.2 and Blender© 3.6. Different versions of the software will present slightly differing interfaces, but the general workflow is still the same.

The last section of the protocol contains a video with an extended overview of the whole process.
Materials
Image capturing:

  • Camera  (ideally with 35mm - 80mm focal length)
  • Tripod
  • Light box (optional)
  • PC or laptop
  • Rotating turntable
  • Modelling clay and plastic wrap
  • Photogrammetric scale marker

3D scanning and processing software:

  • Helicon Remote
  • Agisoft PhotoScan
  • Blender
Safety warnings
Application of this protocol is risk-free
Before start

Note
According to the size of the pieces, the preparation will vary in terms of the distance from the camera to the objects.
To obtain the 3D model we can use photogrammetry or 3D scanning.
Part 1 - Initial remarks and set up preparation
Part 1 - Initial remarks and set up preparation
Place the camera on a tripod (ideally with a zoom lens with a focal length between 35mm and 80mm). Do not use an autofocus lens.
Place the artefact in a light box or, if this is not available, on a plain coloured background.
Place the artefact on a turntable within the workspace.

Fig. 1: Artefact on the turntable inside the light box.

Note
The artefact must always be in the center of the frame

Critical
Use a Photogrammetric scale marker to scale the images afterwards. Three free versions of the photogrammetric scale can be downloaded at this link (Porter, Roussel & Soressi, 2016a; Porter, Roussel & Soressi, 2016b).

Fig. 2: Photogrammetric scale marker.
If the artefact will not stand due to its irregular shape, use an appropriate amount of modelling clay wrapped in plastic wrap to create a modifiable support surface.
With 3 light sources, create diffused lighting from both sides and above. Try to avoid large shadows on the background surface and on the piece.
Shoot with the camera connected to a laptop running Helicon Remote © or any other remote software.

Fig. 3: Set up with the camera at a front angle, connected to the Helicon Remote.
Part 2 - Obtention of 3D models using photogrammetry
Part 2 - Obtention of 3D models using photogrammetry
Open Helicon Remote .
<Click> Toggle Live view for seeing what is on the frame.
Configure Helicon Remote Software

Set the camera on the Camera settings following the next parameters:
Shutter speed: 2 - 1.3
F-number: 8 - 14
100 ISO  
Critical
<Click> on Take picture on the top toolbar.

Fig. 4: Helicon Remote interface with Live View image activated.
Move the artefact 10 degrees on the turntable.
Take another picture.
Repeat steps Go to , Go to , Go to to capture all the 360º.
Change the position of the camera to a high-angle.

Fig. 5: Set up with the camera at a high-angle.
Repeat steps Go to , Go to , Go to from this angle.
Return the camera to a frontal angle and turn the artefact upside down.

Fig. 6: Change of the position of the artefact (180º).
Repeat steps Go to , Go to , Go to with the artefact upside down.
Repeat steps Go to and Go to .
Part 3 - Converting images to 3D
Part 3 - Converting images to 3D
Opening and configuring the Agisoft Photoscan© Software

Fig. 7: Programme overview of the tools and panels used in Photoscan to transform the images into a 3D model.

Legend:

1. Workspace, to organise.  2. Markers to scale the artefact.
3. Scale bars to introduce the scale interval.
4. Model view, to see the development of the artefact.
5. Photo section where all the photos are separated. Masks can be applied in this area.
6. Freeform selection tool.
7. Markers.
8. Update, to apply the measurements to the scale bars.

In the left part of the screen, go to Workspace and tap <Right-click> on the mouse > Add Chunk.
Fig. 8: Chunks are like folders where the photos are stored.
Go to the pictures folder on your computer and drop all the photos with the artefact in a single position, with the front angle and the high angle.

Fig. 9: Photos section of the Photoscan interface.
Create a mask.

Go to the Photos section and open one. Use the magic wand to select the background. <Right-click> and select Add Selection. Do this for each photo.

Fig. 10: The magic wand tool appears on the toolbar when you open an image.
Return to the model view.
Select Workflow on the toolbar and <Click> on Align photos.

Fig. 11: Pop-up window, Align Photos preferences.

Note
If the alignment of the photos is not correct, try the alignment again.

Fig. 12: The alignment works well if all the images appear to be wrapped around the artefact.
In the pop-up window, select Accuracy > Medium and Pair preselection > Disabled.
Select Workflow on the toolbar again and <Click> on Build dense cloud.
On the pop-up window select Quality > Medium.

Fig. 13: Dense cloud setting.
Select Workflow > Build Mesh.
In the following pop-up window leave the default parameters and <Click> the OK button.

Fig. 14: Appearance of the artefact after creating the mesh.
Select Workflow > Build Texture.
In the following pop-up window leave the default parameters and<Click> the OK button.

Fig. 15: Appearance of the artefact after creating the texture.

Note
If you cut a little above the clay, it will be easier to fit later.

Fig. 16: Cutting up the artefact.
Clean up the artefact, use the freeform selection tool and draw over the parts that do not belong to the artefact, and press <DELETE> on your keyboard.
Add Chunk 2 on the Workspace.
In the Photos panel, move all the photos that are left in the pictures folder with the artefact to the other position.
Repeat Go to ,Go to ,Go to ,Go to ,Go to ,Go to .

Open Chunk 1 and go to the Photos pane.
Open one of the photos from the high angle where the Photogrammetric scale marker is visible.
Using the marker tool, <Right-click> on one of the targets and select Create Marker.

Fig. 17: The marker points use the photogrammetric scale marker as a reference.
Repeat Go to on each reference target in the image.
<Right-click> on the target > place marker > choose the point that matches the one in the image above.
Repeat Go to , Go to in every high-angle photo.
On the Reference menu, go to the Makers section and select two points that are parallel to each other, <Right-click> and select create scale bar.
On the scale bar, enter the distance between the targets according to the distance in real life.


Note
Try not to cross the points.


Fig. 18: Creating the scale bars, to scale the artefact.
<Click> the Update icon and return to the model.

Fig. 19: Part of the scaled artefact.
Repeat Go to , Go to , Go to , Go to on chunk 2.
Now go to Workflow > Align Chunks.
In the pop-up window, select the two chunks and leave all the parameters as default.
Workflow > merge chunks.
In the pop-up window, select the two chunks and choose Merge models.

Fig. 20: Merge chunks window.
Fig. 21: Final result.
Export
File > Export Model > Export OBJ/FBX/KMZ…> OK
Part 4- Creating animated sequences using Blender
Part 4- Creating animated sequences using Blender
Blender is a flexible tool with many possibilities that allows the creation of animation sequences using the 3D models previously obtained by photogrammetry. Here we explain the different steps that should be followed up to create core reduction animation sequences.


Open Blender > Select the General option at the first menu.

Fig. 22: Overview of the tools and panels that are used in Blender to animate the artefacts.
Legend:
1. 3D cursor (for moving objects arround the workspace).
2. Rotate tool (to rotate the object).
3. 3D view of the workspace.
4. Timeline (display of the movements in time by keyframes).
5. Viewport shading (view of the object with the texture).
6. Toggle the camera view.
7. Render Properties.
8. Output Properties.
9. Object Properties.
10. Scene collection (space with a list of all the objects).
11. Header (where the object mode options can be found).
Delete the cube by default, <Click> on the cube and press <DELETE>
File > Import > Obj. and browse for the object in the computer folder.
Place all the artefacts on the workspace.

<Click> on one of the artefacts.

Note
To move around the workspace, press the middle mouse button and drag. Use the mouse wheel to zoom in and out.

<Click> on the viewport shading to see the object with the texture.
Go to object on the Header > Set Origin > Origin to centre of mass (surface).
To move objects press <G> on the keyboard and move the mouse to position the object. To change the position more precisely go to the object properties. <Right-click> to set.
To rescale objects, <Click> on the object in the workspace, press<S> and move the mouse in the object properties.
To rotate the object, select the rotate tool and move the mouse on the axis you want to rotate or in the object properties panel.
Repeat steps Go to , Go to . Go to . Go to for each object one by one.

Fig. 23: Motion of objects on the workspace.
Make the set up

Go to the Header > Add and <Click> on Camera.
Select the camera by clicking above it and press <G> on the keyboard, move the mouse, and move the camera until you have the object in the frame.
<Click> on Toggle the camera view and see what’s in the frame.
Adjust the frame, press <G>, and move the mouse, until you have the objects in the frame.
Go to the Header > Add > Light > Point.
Place 3 lights and create a standard 3 point lighting, one light behind the object and two lights from the sides of the camera.

Fig. 24:  Set configuration diagram.
Legend:

1. Artefacts/objects.
2. Camera.
3. Light point.
You can add another light to backfill.
Animation

Select Auto Keying on the Timeline to capture a keyframe every time an object moves.

Fig. 25: Selecting Auto Keying on the Timeline.
Drag the bar on the timeline to the second you want the object's first action to end.
<Click> and drag the object you want to move to the first position.
Place the object where the object's action ends, then <Click> to fix it.

Fig. 26: Timeline view with keyframes per motion action.
Move the bar on  the timeline to the second the action starts.
To rotate the object, set it to the second in which the object has not changed its position, move the bar on the Timeline to the second in which the rotation will end.
Drag the 3D cursor over the object you want to rotate.
Use the Rotate tool and apply the rotation at the second the movement ends on the Timeline.

Fig. 27: Object rotation overview.
Repeat steps Go to , Go to , Go to , Go to for each object.

Note
Check all movements in the camera view and make sure the animation stays in the frame.


Note
To play the animation, tap the spacebar on your keyboard.


Note
Each object has its own timeline.

Render

Delimit the timeline where it says Start/End. Leave a few seconds at the end of the animation.
Go to the Rendering tab.
Output properties > output > name of the animation and where it's saved (folder) > Format File > FFmpeg video > Colour profile RGB > Encoding > container > MPEG-4 > Video > H264 > Lossless > Good.
Render Properties > Scene > Render Engine and change it to Cycles.
Render Properties > Film > Transparent.
Go to the Render tab (not rendering) > render animation.

Fig. 28: Render window.
There are several export options for this software, depending on how you want to use it and how quickly you can reproduce it on your device. You can also capture still images for editing in other programs, such as Adobe Photoshop, or for uploading to a website.

Fig. 29: Output options.

Supplementary video
Supplementary video
The video included in this section shows a detailed step-by-step process following the procedure explained in this protocol. Sample materials to ensure reproducibility of the method are available from this link.


https://videosdigitals.uab.cat/almacen/downloads/998/18156.mp4



Protocol references
ISO 5807:1985 (1985) Information processing. Documentation symbols and conventions for data, program and system flowcharts, program network charts and system resources charts. International Organization for Standardization. February 1985, 25 p
Myler, HR (1998). Fundamentals of engineering programming with C and Fortran. Cambridge University Press.

Porter, ST; Roussel, M; Soressi, M. (2016a).A Simple Photogrammetry Rig for the Reliable Creation of 3D Artifact Models in the Field: Lithic Examples from the Early Upper Paleolithic Sequence of Les Cottés (France). etrieved from the Data Repository for the University of Minnesota, http://dx.doi.org/10.13020/D6201D.
Porter, ST, Roussel, M & Soressi, M (2016b). A simple photogrammetry rig for the reliable creation of 3D artefact models in the field: lithic examples from the Early Upper Paleolithic sequence of Les Cottés (France). Advances in Archaeological Practice, 4 (1), 71-86. https://doi.org/10.7183/2326-3768.4.1.71