The Mokume Dataset
Authors/Creators
-
1.
The University of Tokyo
- 2. Gifu Prefectural Research Institute for Human Life Technology
-
3.
Nihon University
-
4.
École Polytechnique Fédérale de Lausanne
-
5.
National Taiwan University of Arts
-
6.
Lulea University of Technology
-
7.
Norwegian University of Science and Technology
-
8.
Luleå University of Technology
-
9.
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
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