# Instruction ### ShapeNetCore #### ShapeNetCore v2 ShapeNetCore data release v2 (Fall 2016) This second release of ShapeNetCore is an update to ShapeNetCore v1 with improved quality of model geometry and fixed issues relating to materials and textures. The files contain ShapeNetCore: a densely annotated subset of ShapeNet released to the research community. Each zip file is named by the synset noun offset in WordNet (version 3.0) as an eight-digit zero padded string. For example, bench is contained within 02828884.zip since the WordNet synset offset for bench is 02828884 (you can browse WordNet at ). The corresponding ImageNet synsets can be accessed at where is replaced by the synset offset (note that ImageNet includes an 'n' prefix for noun synsets). Within each synset zip file there is a set of OBJ files of all the 3D models annotated under that synset. Each model is under a directory named after its source id, which is the id of the original model on the online repository from which it was collected. Within the model directory, you will find texture images, json,mtl,obj, solid.binvox and binvox models and png screenshots files. You can view OBJ mesh files with software such as Assimp, the Open Asset Import Library (). The v2 package provides improved .obj+mtl format model data that replaces the .obj+.mtl data in ShapeNetCore v1. NOTE: The OBJ files are now pre-aligned so that the up direction is the +Y axis, and the front is the -Z axis (this fixes the mirroring issue in ShapeNetCore v1). The Y-Z plane is the bilateral symmetry plane for most categories. The taxonomy.json file in ShapeNetCore v2 contains a simple JSON format representation of the ShapeNetCore synset taxonomy indicating for each synset the synset offset (synsetId), the synset lemma (name), an array of the children synsets ids (children), and the total number of model instances (numInstances). This JSON file is obtained from the more comprehensive ShapeNet taxonomy JSON at by filtering with the command: jq "[.[] | recurse (.children[]?) | \{synsetId: .metadata.name, name: . metadata.label, children: [.children[]?.metadata.name], numInstances: .metadata. numInstances \}]" shapenetcore.taxonomy.json (requires the JSON filter library jq which can be obtained from , a linux x64 binary is included in this package) If you use ShapeNet data you agree to abide by the ShapeNet terms of use (see terms-of-use.txt). You are only allowed to redistribute the data to your research associates and colleagues provided that they first agree to be bound by these terms and conditions. For more information, please contact us at shapenet-webmaster@lists. stanford.edu #### Data organization The downloaded and unzipped Shapenetcore.v2 consists of a set of zip and csv files. Each zip file consists of a set of model directories organized as follows: ``` - - - models - model_normalized.json : Metadata for normalization of the 3D model (bounding box, centroid) and model statistics (number of vertices, etc) - model_normalized.obj : 3D mesh in OBJ format (specifying vertices and faces) - model_normalized.mtl : Materials file for OBJ; Includes the name of texture files and material properties. - model_normalized.solid.binvox : Filled-in binary voxelizations of models in binvox format - model_normalized.surface.binvox : Binary voxelizations of model surfaces in binvox format - images - jpg, png: Textures for the 3D model - ... - screenshots - png : 2D renderings of the 3D model from different angles - ... - ... - ... ``` #### ShapeNetCore v1 ShapeNetCore data release v1 (July 2015) These files contain ShapeNetCore: a densely annotated subset of ShapeNet released to the research community. Each zip file is named by the synset noun offset in WordNet (version 3.0) as an eight-digit zero padded string. For example, bench is contained within 02828884.zip since the WordNet synset offset for bench is 02828884 (you can browse WordNet at ). The corresponding ImageNet synsets can be accessed at where is replaced by the synset offset (note that ImageNet includes an 'n' prefix for noun synsets). Within each synset zip file there is a set of OBJ files of all the 3D models annotated under that synset. Each model is under a directory named after its source id, which is the id of the original model on the online repository from which it was collected. Within the model directory, you will find OBJ, MTL and texture image files. You can view OBJ mesh files with software such as Assimp, the Open Asset Import Library (). In addition to the model data, you will find .csv (comma-separated value format) files that contain metadata associated with the models in each synset. The columns of these CSV files and their interpretation are as follows: fullId : the unique id of the model wnsynset : comma-separated list of WordNet synset offsets to which the model belongs wnlemmas : comma-separated list of names (lemmas) of the WordNet synsets to which the model belongs up : normalized vector in original model space coordinates indicating semantic "upright" orientation of model front : normalized vector in original model space coordinates indicating semantic "front" orientation of model name : name of the model as indicated on original model repository (uncurated) tags : tags assigned to the model on original model repository (uncurated) NOTE: The OBJ files have been pre-aligned so that the up direction is the +Y axis, and the front is the +X axis. In addition each model is normalized to fit within a unit cube centered at the origin. he X-Y plane is the bilateral symmetry plane for most categories. In addition to the existing CSV files, you can re-download the current metadata from the ShapeNet server using the get-metadata.sh shell script (requires bash and wget). The taxonomy.json file contains a simple JSON format representation of the ShapeNetCore synset taxonomy indicating for each synset the synset offset (synsetId), the synset lemma (name), an array of the children synsets ids (children), and the total number of model instances (numInstances). This JSON file is obtained from the more comprehensive ShapeNet taxonomy JSON at by filtering with the command: jq "[.[] | recurse (.children[]?) | {synsetId: .metadata.name, name: . metadata.label, children: [.children[]?.metadata.name], numInstances: . metadata.numInstances }]" shapenetcore.taxonomy.json (requires the JSON filter library jq which can be obtained from , a linux x64 binary is included in this package) ##### Data organization The downloaded and unzipped Shapenetcore.v1 consists of a set of files. Each file consists of a set of model directories and csv files organized as follows: ``` - - - model.obj : (3D Rotatable version of the image) - model.mtl : Materials file for OBJ; Includes the name of texture files and material properties. - images - jpg, png: Textures for the 3D model - .csv : (Metadata associated with the model of the synset) - ... ``` ### ShapeNetSem ShapeNetSem v0 (June 2015) There are several pieces of model data that are available: - models-OBJ.zip : OBJ format 3D mesh files (with accompanying MTL material definition files) - models-textures.zip : texture files used by above 3D mesh representations - models-COLLADA.zip : COLLADA (DAE) format 3D mesh files - models-binvox.zip : Binary voxelizations of model surfaces in binvox format - models-binvox-solid.zip : Filled-in binary voxelizations of models in binvox format - models-screenshots.zip : Pre-rendered screenshots of each model from 6 canonical orientations (front, back, left, right, bottom, top), and another 6 "turn table" positions around the model In addition to the model data, we also provide the following metadata: - metadata.csv: metadata associated with each model. - categories.synset.csv: maps manual category labels to WordNet synsets and glosses - materials.csv : set of per-category material priors extracted from OpenSurfaces [Bell et al. 2014] dataset - densities.csv : material densities (g / cm3) and static coefficients of friction - taxonomy.txt : defines the taxonomy of our manual categories. Lines start with parent category followed by child categories, all separated by tabs. Note comment lines starting with '#' For downloading other types of metadata, please refer [here](http://shapenet.cs.stanford.edu/shapenet/obj-zip/ShapeNetSem.v0/README.txt).