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
This protocol introduces the "Validated Entheses-based Reconstruction of Activity 2.0" (VERA 2.0), an advanced iteration of the original VERA 1.0, previously developed by the author of this protocol (Karakostis, 2022; Karakostis & Harvati, 2021; Karakostis & Lorenzo, 2016). VERA 1.0 has become a valuable tool in anthropological studies for repeatably delineating, measuring, and analyzing 3D muscle attachment sites (surface areas), demonstrating that entheseal 3D surface variation can reflect habitual muscle coordination and physical activity. VERA 2.0 builds on this foundation with significant enhancements, offering a semi-automated protocol that greatly simplifies the 3D area quantification process. It requires only one initial set of manual steps – selecting a pre-specified broader region of the bone around the enthesis – after which the remaining procedure can be fully automated using a stored filter script (e.g., mlx file in the software Meshlab). After some practice, this semi-automation can potentially reduce the entire 3D area measurement time to less than 2 minutes per enthesis (see example video below), enabling the analysis of very large skeletal samples within a few working days. Unlike VERA 1.0, which measures the entire 3D surface area of bony structures associated with a muscle and/or ligament (e.g., the entire tubercle), VERA 2.0 identifies 3D surface deformations and irregularities within the footprint of the attaching soft tissue (i.e., “entheseal changes”), which can arguably be more clearly associated with direct muscle or ligament loading. Preliminary experimental analyses, which will be presented in the validation paper associated with this protocol, indicate that VERA 2.0 can effectively and repeatably identify activity-related differences, similar to VERA 1.0.
This protocol provides a comprehensive, step-by-step guide for executing the VERA 2.0 workflow, covering both manual and automated components. It is designed to enable users to achieve measurement repeatability without necessarily requiring training from the developer, though direct contact with the author is encouraged for questions or explicit recommendations regarding particular entheses.
Guidelines
1. Some sections ("Parts") start with an introductory “Note” inserted within the first step right before the description of the step itself.
2. Occasionally, important “Notes” are also included within steps, where necessary or useful.
3. Software options or commands are usually indicated within parenthesis (e.g., XYZ --> XYZ --> XYZ).
4. IMPORTANT: The entire analytical process of this protocol (Parts 1 to 4) is described in detail only for the insertion site of muscle opponens pollicis (OP) on the right first metacarpal bone. For Part 2, which focuses on the manual component of this protocol (i.e., the selection of a broader bone area around the enthesis), another eight examples are concisely provided in the form of eight Step-Cases (2-9). Nevertheless, Parts 3 and 4 of the protocol are only visible when selecting Step-Case 1 ("1. OP"). This is to avoid redundancy, given that Parts 3 and 4 are identical for any enthesis and can be fully automated using a Meshlab filter script (as shown in the provided video, below).
5. IMPORTANT: In Step 7 (Part 2), Step-Cases 1-5 are accessible via a drop-down menu located below the large "Explanatory Note." However, Step-Cases 6-9 will only become visible after selecting Step-Case 5 ("5. FDS") and scrolling down to find another drop-down menu. After viewing these additional example cases, you will need to re-select the first Step-Case ("1. OP") from the first drop-down menu to view Parts 3 and 4 of the protocol again.
Materials
3D scanning and processing software: MeshLab (used version: v2023.12)
3D surface models of bones with a resolution of at least 300 microns (no texture required)
Before start
Please consider the following recommendations (1 and 2) before applying VERA 2.0:
1. When selecting the muscle or ligament attachment sites (entheses) for analysis in your study, the following must be kept in mind:
- VERA 2.0 is designed to identify projecting surface deformations and irregularities within entheseal areas, broadly referred to in the literature as “entheseal changes”. This makes VERA 2.0 particularly effective for detecting such changes in entheses that have the potential to exhibit these alterations at the sample level, even if not present in all individuals. Some key examples of such entheses include the occipital protuberance (cranium), the masseter muscle insertion (mandible), the costoclavicular ligament enthesis (clavicle), the deltoid muscle attachment (humerus), the biceps brachii enthesis (radius), various key muscle entheses of the hand (e.g., opponens pollicis, extensor pollicis brevis, flexor pollicis longus, flexor digitorum superficialis, opponens digiti minimi, and the origin sites of the interossei muscles), the iliac crest (pelvis), the greater trochanter and supracondylar line (femur), the tibial tuberosity (tibia), the calcaneal tuberosity (calcaneus), and multiple muscle entheses of the pedal metatarsals and phalanges. If there is insufficient bibliographic information on a particular enthesis and its potential changes, it is recommended to visually examine its morphology across your sample and assess whether any consistent irregularities or deformations occur that cannot be exclusively attributed to taphonomy (damage), injury, or inflammatory conditions unrelated to physical activity (e.g., systemic diseases). If an enthesis consistently shows smooth and unaltered surfaces across all individuals in your sample (i.e., no visible entheseal changes), then the traditional "VERA 1.0" approach, which focuses on overall 3D area measurement rather than within-enthesis surface changes, may be more suitable.
- When the aim of the study is to reconstruct habitual muscle or ligament use based on entheseal morphology, the presence of large pathological lesions (e.g., osteophytic or osteolytic) or taphonomic alterations within the enthesis that may likely be unrelated to physical activity can significantly impact the reliability of the measurements. If such alterations are visually identifiable and have a maximum diameter exceeding 4 mm (i.e., the threshold for defining third-level enthesopathies; see criteria in Mariotti et al., 2004), it is hereby recommended to exclude that enthesis from the sample before applying VERA 2.0. Alternatively, if the observer decides to retain the enthesis in the analysis – due to the unique importance of the specimen or the suspicion that the potential enthesopathy may be linked to activity-induced biomechanical stress – it is essential to clearly highlight the presence of these alterations in the study’s results and interpretations. In cases where such large pathological or taphonomic alterations are within VERA 2.0’s “broader selection region” but clearly not within the entheseal footprint region itself, users must ensure that the afflicted areas are manually excluded from the selection (refer to Step-Case 1, Step 11). Similarly, for all remaining lesions below the 4 mm threshold, follow the treatment guidelines provided in Step-Case 1, Step 11.
2. Please note that the delineation process detailed in this protocol is carried out using Meshlab v.2023.12 (ISTI-CNR, Pisa, Italy). While other software may be used as long as they support the same filtering algorithms, the specific steps outlined here may differ. The predominant portion of the VERA 2.0 workflow (Steps 13 to 23) can become fully automated by using a created Meshlab mlx filter script. For convenience, an example filter script is provided for download below, which can also potentially be reused in future studies. If necessary, after loading an existing script in Meshlab, its exact parameters can also be directly adjusted (using the process outlined in the paragraph below). Once the workflow has been applied to the first enthesis of a sample, all subsequent measurements of that enthesis in other individuals can be completed much faster by re-using such a script, potentially taking less than 2 minutes per individual enthesis (as demonstrated in the example delineation video provided further below). This allows for large samples to be analyzed in just a few days.
If observers wish to develop and use their own filter script in Meshlab, they are encouraged to save their filter script after completing the protocol manually for the first enthesis of their sample (Filters --> Show Current Filter Script --> Save Script). Then, for all other entheses in the sample, as long as the parameters remain unchanged, Steps 13 to 23 can be applied automatically with just a few clicks (Filters --> Show Current Filter Script --> Open Script --> Apply Script). Before running the script each time, it is advisable to quickly double-check that all parameters (and especially the parameter indicated in Step 21, which performs outlier removal based on a specific diameter threshold) are consistent by reviewing them in the "Edit Parameters" tab within the “Show Current Filter Script” window. To ensure consistency, it is strongly recommended to use the same exact script across all 3D models of the sample, avoiding discrepancies in the applied parameters.
Example Video and Reusable Meshlab Filter Script
The video below demonstrates the semi-automated VERA 2.0 approach for analyzing the insertion site of muscle opponens pollicis on a human right first metacarpal bone in under 2 minutes. The example delineation video (mp4) and the associated Meshlab filter script (mlx) can also be found here: Video and Filter Script Link. The 3D surface model (ply format) was created using an Artec Space Spider structured-light scanner (Artec Inc., Luxembourg) and has a resolution of 100 microns. For background information on the bone depicted in the video, see Karakostis and Hotz (2022).
VERA 2.0 filter script.mlx6KB
Contents:
Part 1 – Technical requirements and recommendations
Part 2 –Selection of a broader bone area around the enthesis (manual component)
Part 3 – Mapping of projecting structures
Part 4 – Delineation and measurement of projecting structures
Part 1 – Technical requirements and recommendations
Part 1 – Technical requirements and recommendations
The 3D surface model to be analyzed can be developed using any technology (e.g., laser, structured light, computed tomography, or photogrammetry). The 3D model format used in this protocol is ply, but others are also compatible (e.g., obj or stl). Texture information is not required for VERA
Download and use the open-access software Meshlab Version 2023.12 or higher (https://www.meshlab.net/), since some steps of this protocol require functions not available in older versions of the software. If another 3D image processing software is used, please ensure that all steps of this protocol are available and that the same (or equivalent) 3D filtering algorithms are employed. Exact specifications on the software’s tools and functions can be found in Meshlab’s manual and associated references (available at https://www.meshlab.net/#references and https://www.meshlab.net/#support).
Confirm that the surface model’s resolution is adequate for virtually visualizing entheseal surface changes. Based on trial tests, a minimum resolution of 300 microns is required, though a resolution of 200 microns or lower is strongly recommended for optimal performance.
Ensure that all 3D models in your sample have the same or very similar resolution. Considerable variations in resolution, which may occur due to different scanning technologies or parameters, can lead to inconsistencies in the identification and measurement of entheseal changes. If significant discrepancies are present, it is advisable to standardize the resolution across specimens (models). This can be done using mesh resampling techniques, such as Meshlab's "uniform mesh resampling," with a precision set to 50 or 100 microns to maintain consistency across all models.
Part 2 – Selection of a broader bone area around the enthesis (manual component)
Part 2 – Selection of a broader bone area around the enthesis (manual component)
..
Open Meshlab and load the 3D surface model (e.g., either by selecting File --> Import Mesh --> 3D file selection --> Open, or by “drag & drop”). The 3D surface model is expected to appear (Fig. 1).
If texture is visible on the model (and you do not wish to remove it from the model prior to the analysis), deactivate it by moving your cursor to the right side of Meshlab (Fig. 2) and selecting “Off” next to “Texture Coord” and/or “User-def” next to “Color” (and choosing the grey color, which is the default).
Step case
1. Opponens pollicis (OP)
18 steps
The first Step-Case focuses on the main enthesis example used in this protocol, which is the insertion site of opponens pollicis along the lateral border of the right first metacarpal. The instructions in the Step-Case are more detailed than in the others.
Using your cursor in Meshlab, rotate the first metacarpal from its initial random position (e.g., the one depicted in Fig. 1) to the specific orientation provided in Figure 3 below. The observer must view the first metacarpal from a fully lateral perspective, with the bone placed in an upright position, the distal end facing upward, and the proximal end downward. The characteristic distal-lateral ridge of the enthesis must be visible to the extent possible (as shown in Fig. 3).
Colorize the bone surface using the “Discrete Curvatures” filter (Filters --> Colors creation and processing --> Discrete curvatures --> Apply) and maintaining the default option “Mean” under “Type”, to visualize surface curvature in the form of relative projections (in shades of blue) and depressions (shades of red) (Fig. 4). This facilitates the broader selection process indicated below, at Steps 9 to 12.
Select Meshlab's "Z-painting tool" by clicking the appropriate icon with the brush on the right side of Meshlab’s toolbar and then, in the window that pops up, click on the second (lower) brush that is used for manually selecting 3D surface areas. The user can adjust the size and shape of the brush to their convenience (Fig. 5). Areas can be selected by pointing the cursor to the desired location on the model’s surface and pressing the left mouse button. Respectively, areas can be de-selected by pressing the right mouse button.
When using VERA 2.0 to analyze the insertion site of opponens pollicis on the first metacarpal, the user should always select the area indicated in Fig. 6, below. This is defined as the “broader selection region” (BSR) for that enthesis. In particular, it is advised that approximately the distal 4/5ths of the shaft must be selected (not considering the articular surfaces in this estimation), excluding the proximal 1/5th. The latter portion includes the tubercle that accommodates the distinct insertion site of abductor pollicis longus, whose distal extent can vary considerably among individuals but is not known to extend beyond 1/5th of the bone. Subsequently, the user must make sure to deselect the articular surface of the metacarpal head, including its rim (typically carrying an elongated blue-colored line, after the “Discrete Curvatures” filter is applied).
Additionally, if the selected BSR encompasses clearly identifiable taphonomic alterations and/or pathological lesions (see example in Fig. 7A), these specific regions must also be manually deselected. This also includes alterations within the exact footprint of the tendon or ligament, unless the observer explicitly aims to investigate a potential link between potential enthesopathy and activity-induced stress in their study (in which case the presence of potential enthesopathies must be highlighted in that study’s results and interpretations). If that is the study's aim or intent, then this Step can be intentionally ignored. Otherwise, as explained above (in the "Before starting" section of this protocol), such artifacts must be removed, as they may be associated with taphonomic effects or various pathological reactions unrelated to lifetime muscle or ligament use.
Nevertheless, it should be clarified that when such distinguishable alterations in the BSR are clearly isolated from other projections or depressions (thus tending to appear either as blue-colored "islands" or red-colored "pits" after applying the “Discrete Curvatures filter”) and their maximum diameter is less than 2 mm (see example in Fig. 7B), they do not necessarily need to be deselected manually, as a later step of the VERA 2.0 workflow (i.e., Step 21) will exclude them automatically. Therefore, such small and isolated structures on the bone surface can be safely ignored, greatly facilitating the manual selection stage required for VERA 2.0. In cases where it is not immediately clear whether an isolated structure surpasses the threshold of 2 mm, the maximum length of a suspected artifact can be quickly measured on the 3D model using the “Measuring Tool” of Meshlab (see examples in Fig. 7). Additionally, the user can easily double-check that such isolated structures did not make it to the final delineation, at the final step of the protocol (i.e., Step 24). If any of them finally did, the observer can choose to select them directly using the marker tool (or other available tools), delete their vertices, and re-measure the remaining delineated area (see steps below).
Finally, the user must ensure that the selection (BSR) did not accidentally include remote and unrelated aspects of the bone. For this enthesis (opponens pollicis), the observer should first rotate the bone model palmarly (Fig. 8A) and ensure that the selection does not surpass the palmar aspect’s median (central) axis (indicated here by a black line). Subsequently, the user should view the bone from a dorsal perspective (Fig. 8B) and confirm that the selection does not surpass the dorsal aspect’s median (central) axis (indicated here by a black line). Additionally, in case a written label occurs within the selected area (e.g., indicating the specimen label) and this is captured by the 3D scanner, it is advised to manually deselect the labeled selection if possible (as was done in Fig. 8C). Even though the later steps of the automated part of the protocol will usually remove these markings before the final measurement (as long as the lines of the letters are not more than 2 mm in maximum length), it is safer to already manually exclude them at this stage (also see in the provided example delineation video of the "Before starting" section). Finally, the observer is encouraged to additionally observe the bone’s metacarpal head from a fully distal perspective, ensuring that the entire articular surface is clearly visible (to the extent possible). This allows for confirmation that no part of the distinguishable articular surface’s rim was accidentally selected (as demonstrated in the provided video).
Part 3 – Mapping of projecting structures
Part 3 – Mapping of projecting structures
Select the vertices corresponding to your BSR in Meshlab (Filters --> Selection --> Select Vertices from Faces) (Fig. 18). Subsequently, apply Laplacian smoothing on the selected area, (Filters -->
Smoothing, Fairing and Deformation --> Laplacian Smooth --> Apply), maintaining Meshlab's default number of smoothing steps (3).
Select the bone areas surrounding the BSR itself by inverting the current selection (Filters --> Selection --> Invert Selection) (Fig. 19).
Crop the selected bone regions surrounding the BSR, using the “Delete Selected Vertices” tool located on the right side of Meshlab’s toolbar (Fig. 20).
To enhance the distinction of all smoothly projecting areas on the bone surface (i.e., blue-colored structures in the figure), apply colorization to the BSR surface based on computed principal curvature directions (Filters → Color Creation and Processing → Compute Curvature Principal Directions). In the pop-up panel, use the software’s default method "Quadric Fitting" and set the quality to "Min Curvature." This approach will colorize each vertex of the BSR according to the minimum observed curvature, which is ideal for capturing more subtle surface variations (Fig. 21). In case the filter fails to apply due to the presence of manifold edges, then these have to be first removed using the “Repair non Manifold Edges” option (Filters --> Cleaning and Repairing --> Repair non Manifold Edges --> Apply).
To standardize all shades of blue in the BSR, equalize the color histogram to ensure uniform blue shades (Filters --> Color Creation and Processing --> Equalize Vertex Color --> Apply) (Fig. 22).
Part 4 – Delineation and measurement of projecting structures
Part 4 – Delineation and measurement of projecting structures
Select all projecting areas in the BSR, which should appear in blue after the previous colorization process (Fig. 23). Navigate to "Filters --> Selection --> Select Faces by Color". In the pop-up window, choose the blue color (#0000ff) and set “Variation from Blue or Value” to the maximum (1.0). Leave the remaining settings at their default values and click Apply.
Invert the selection (as previously described in Step 14) to select all areas of the BSR except for the previously selected blue regions (Filters --> Selection --> Invert Selection) (Fig. 24).
Crop the selected regions surrounding the blue-colored projecting areas, using the “Delete Selected Vertices” tool located on the right side of Meshlab’s toolbar (Fig. 25).
In the remaining surface (now entirely blue), automatically detect and remove small and unconnected bone projections ("outliers" or "islands"), as these cannot typically be safely associated with the main entheseal changes observed (Filters --> Cleaning and Repairing --> Remove Isolated Pieces - wrt Diameter --> Apply). In the pop-up window, set the diameter threshold to 2 mm and then click Apply (Fig. 26).
Note that the percentage (%) automatically indicated next to that value (2 mm) tended to be around 5% for the example human specimens analyzed for developing this protocol and its associated validation paper.
Select all remaining regions (Filters --> Selection --> Select All) (Fig. 27).
Measure the surface area of the final selected blue regions in square mm (provided the model is calibrated accordingly) by navigating to “Filters --> Quality Measure and Computations --> Compute Area/Perimeter of Selection”. The “Selection Surface Area” measurement will be displayed in the window at the bottom right corner of Meshlab (Fig. 28). The exact location of the measurement indication is also highlighted in the example delineation video provided in the "Before starting" section.
Optionally, you may project the delineated entheseal changes onto the bone 3D model of the bone by importing the original 3D model file (e.g., the ply file of the first metacarpal) into Meshlab. To overlay this model, you may "drag and drop" the file into the same workspace where the processed model is displayed, by holding down the left mouse button during the action. This overlay process, as illustrated in Fig. 29 as well as the example delineation video provided in the "Before starting" section, allows you to visualize the selected regions on top of the bone model. It provides an opportunity for final verification to ensure that the workflow was executed correctly and to check for any potentially irrelevant areas still selected (e.g., areas outside the defined BSR or regions with clear taphonomic or pathological damage). If additional adjustments are needed, such as eliminating erroneously selected areas using Meshlab’s selection tools, document the decision and reasoning clearly in your study’s Methods section (optimally using illustrations). Eight additional examples of this process are illustrated below in Fig. 30, corresponding to the eight example cases of BSR selection discussed in Part 2 of this protocol (Case-Steps 2-9).
Protocol references
Karakostis FA. Statistical protocol for analyzing 3D muscle attachment sites based on the “Validated Entheses‐based Reconstruction of Activity” (VERA) approach. Int J Osteoarch. 2022;33: 461–474. doi: https://doi.org/10.1002/oa.3196
Karakostis FA, Harvati K. New horizons in reconstructing past human behavior: Introducing the “Tübingen University Validated Entheses-based Reconstruction of Activity” method. Evol Anthropol. 2021;30: 185–198. doi: https://doi.org/10.1002/evan.21892
Karakostis FA, Hotz G. Reflections of manual labor in the hand entheses of early industrial women workers with extensively documented life histories. Am J Biol Anthrop. 2022;183: e24636. doi: https://doi.org/10.1002/ajpa.24636
Karakostis FA, Hotz G, Scherf H, Wahl J, Harvati K. Occupational manual activity is reflected on the patterns among hand entheses. Am J Phys Anthropol. 2017;164: 30–40. doi: https://doi.org/10.1002/ajpa.23253
Karakostis FA, Lorenzo C. Morphometric patterns among the 3D surface areas of human hand entheses. Am J Phys Anthropol. 2016;160: 694–707. doi: https://doi.org/10.1002/ajpa.22999
Mariotti V, Facchini F, Belcastro MG. Enthesopathies--proposal of a standardized scoring method and applications. Coll Antropol. 2004;28: 145–159.