# Title of Dataset: 
Limestone Spheroid 3D Models for "The limestone spheroids of ‘Ubeidiya: Intentional imposition of symmetric geometry by early hominins?"

## Description of the data and file structure
This dataset contains all 150 3D models of the limestone spheroids used in this manuscript.
The original artifacts are housed at the Institute of Archaeology, Hebrew University of Jerusalem.

Each .mat file represents a 3D scan of a spheroid and contains the following variables:
	'faces' - nx3 matrix describing how the coordinates (vertices) of the 3D scan are connected in a triangular mesh. Values are integers and correspond to the index of the 'vertices' variable.
	'manual_pos_matrix' - a 3x3 rotation matrix for manually orienting the vertices according to the position chosen using the manual positioning function of Artifact3-D.
	'Mm' - volumetric information for the 3D scan in cubic mm. 
	'RTia' - a 3x3 rotation matrix for automatically orienting the vertices according to the Inertia Positioning function of Artifact3-D.
	'Tuzy' - a 3x3 rotation matrix for automatically orienting the vertices according to the Normal Positioning  function of Artifact3-D.
	'vertices' - nx3 matrix representing the x,y,z coordinates of the 3D scan. Values are in mm.  
	'Vp1' - volume of the 3D scan in cubic mm. 

## Code/Software
3D models are in qins (.mat) format for use in MATLAB and the Artifact3-D software, available open source from https://sourceforge.net/projects/artifact3-d/. GNU Octave is an open-source alternative to MATLAB.
For more details about Artifact3-D and its user manual see Grosman L, Muller A, Dag I, Goldgeier H, Harush O, Herzlinger G, et al. (2022) Artifact3-D: New software for accurate, objective and efficient 3D analysis and documentation of archaeological artifacts. PLoS ONE 17(6): e0268401. https://doi.org/10.1371/journal.pone.0268401