Published August 2025 | Version v1
Dataset Open

The Mokume Dataset

  • 1. ROR icon The University of Tokyo
  • 2. Gifu Prefectural Research Institute for Human Life Technology
  • 3. ROR icon Nihon University
  • 4. ROR icon École Polytechnique Fédérale de Lausanne
  • 5. ROR icon National Taiwan University of Arts
  • 6. EDMO icon Lulea University of Technology
  • 7. EDMO icon Norwegian University of Science and Technology
  • 8. ROR icon Luleå University of Technology
  • 9. ROR icon Shibaura Institute of Technology
  • 10. Reichman University
  • 11. École polytechnique fédérale de Lausanne, EPFL

Description

This dataset is associated with the journal paper "The Mokume Dataset and Inverse Modeling of Solid Wood Textures" (PDF, SIGGRAPH 2025). The data includes the Mokume Dataset, which captures real data of wood textures. It also includes a trained model (U-Net) for extracting annual rings from photographs.

Abstract

We present the Mokume dataset for solid wood texturing consisting of 190 cube-shaped samples of various hard and softwood species documented by high-resolution exterior photographs, annual ring annotations, and volumetric computed tomography (CT) scans. A subset of samples further includes photographs along slanted cuts through the cube for validation purposes.

Using this dataset, we propose a three-stage inverse modeling pipeline to infer solid wood textures using only exterior photographs. Our method begins by evaluating a neural model to localize year rings on the cube face photographs. We then extend these exterior 2D observations into a globally consistent 3D representation by optimizing a procedural growth field using a novel iso-contour loss. Finally, we synthesize a detailed volumetric color texture from the growth field. For this last step, we propose two methods with different efficiency and quality characteristics: a fast inverse procedural texture method, and a neural cellular automaton (NCA). 

We demonstrate the synergy between the Mokume dataset and the proposed algorithms through comprehensive comparisons with unseen captured data. We also present experiments demonstrating the efficiency of our pipeline’s components against ablations and baselines. 

Folder Structure & Contents

There are three items: 

  • MokumeDataset (approx. 20,000 MB). This folder contains the raw data, including high-resolution photographs, annotations, and more, of the documented 190 cube samples from 17 different species.
  • ImageParis (approx. 240 MB). This folder contrains image pairs formated for the image translation task of converting a wood color image into an annual ring localization image.
  • The file unet_trained_model.pt contains a trained U-Net, which takes a 64x64 pixel patch of a color photograph of wood and translates it to an annual ring licalization image. It is trained on the image pairs in the above folder.

Refer to sections below for detailed information about the contents of the folders.

MokumeDataset Folder

Inside the MokumeDataset folder, there are 190 subfolders, one for each sample, named XXNN where 

  • XX = species code of 1 or 2 characters (e.g., "B", see "Wood Species Codes" below).
  • NN = samples number (e.g., "02")

File content of each subfolder XXNN:

File name(s) Description Image channels, size No. cube samples

A_col.png

B_col.png

C_col.png

D_col.png

E_col.png

F_col.png

Six high-resolution photographs of the six external surfaces of the cube sample Color images (RGB), irregular size, approximately 1,880x1,880 px 190 (all)

A_ann.png

B_ann.png

C_ann.png

D_ann.png

E_ann.png

F_ann.png

Annual ring annotation data for the six external surfaces of the cube sample

Greyscale images, 256x256 px

190 (all)
vol_ct.npz A low-resolution volumetric computer tomography (CT) scan of the cube Grayscale 3D image, 128x128x128 px

185. All exept five samples, data missing for NR06-10

cut1_col.png or cut2_col.png A high-resolution photograph of a surface of a slanted cut (type 1 or 2) through the cube Color image (RGB), irregular size, approximately 1,880x1,880 px 38. Two or four samples per species.

For more information, refer to the paper (PDF), in particular:

  • The cube unfolding convention Fig. 29.
  • The annual ring annotation image structure in Fig. 30.
  • Details about the slanted cut surface position in the cube in Fig. 31. 

ImagePairs Folder

The ImagePairData folder contains formated data for the image translation task of identifying annual ring patterns in a color photo of wood. Inside this folder, there are two subfolders: test_data and training_data. Each folder contains image pairs:

File name Description Image channels, size No. training images No. test images
*.png A photograph of an external surface of a cube sample Color image (RGB), 256x256 px 912 228
*_arl.png An annual ring localization image corresponding to *.png. Greyscale image, 256x256 px 912 228

where * is a unique image identifier. This data is created based on the raw data in the MokumeDataset folder. In particular, the color images are resized to smaller and exactly square images, and annual ring annotations are processed into annual ring localization images, which is a smooth representation of the annual rings, suitable for optimization/learning. For more information about how the localization images were created, refer to the paper (PDF), in particular Section 5.1.1 Training data and Fig. 12.

Wood Species Codes

Species Code Species Name Species Scientific Name Cube Sample Count
B Beech Fagus spp. 10
BW Black walnut Juglans nigra 10
CH Cherry Prunus serotina 10
CN Kuri Castanea crenata 10
H Hinoki Chamaecyparis obtusa 20
IC Icho Ginkgo biloba 10
K Keyaki Zelkova serrata 10
KR Kurumi Juglans mandshurica 10
MP Maple  Acer spp. 10
MZ Mizume Betula grossa 10
N Nara Quercus crispula 10
NR Nire Ulmus davidiana 10
P Platanus Platanus occidentalis 10
RO Red oak Quercus rubra 10
S Sakura Prunus spp. 10
SG Sugi Cryptomeria Japonica 20
TC Tochinoki Aesculus turbinata 10

 

Other info

Project page

For more information, visit: https://mokumeproject.github.io/ 

Reference

Maria Larsson, Hodaka Yamaguchi, Ehsan Pajouheshgar, I-Chao Shen, Kenji Tojo, Chia-Ming Chang, Lars Hansson, Olof Broman, Takashi Ijiri, Ariel Shamir, Wenzel Jakob, and Takeo Igarashi. 2025. The Mokume Dataset and Inverse Modeling of Solid Wood Textures. ACM Trans. Graph. 44, 4 (August 2025), 18 pages. https://doi.org/10.1145/3730874

Files

ImagePairs.zip

Files (21.3 GB)

Name Size Download all
md5:6337241275924139de1bb65f08e0d599
245.6 MB Preview Download
md5:63760fa916601fedec355ae44474e3ab
20.9 GB Preview Download
md5:fe9f6ec56781f19a9455c961adc40ed1
138.3 MB Download

Additional details

Additional titles

Alternative title (En)
The Mokume Dataset and Inverse Texturing of Solid Wood

Funding

Japan Science and Technology Agency
ACT-X JPMJAX210P
The University of Tokyo
A collaborative research fund between Mercari Inc. R4D and RIISE
Japan Society for the Promotion of Science
KAKENHI JP23K19994
Japan Science and Technology Agency
AdCORP JPMJKB2302
Japan Science and Technology Agency
ASPIRE JPMJAP2401

Dates

Accepted
2025

Software

Repository URL
https://github.com/marialarsson/mokumeproject
Programming language
Python
Development Status
Concept