README.md

---
library_name: peft
base_model: cerebras/Cerebras-GPT-256M
license: apache-2.0
language:
- en
tags:
- pcgml
- pcg
- biome
- terrain
---

# Model Card for Model ID

Part of bachelor thesis focusing on generating 3d terrain from text.<br>
Biome Definition is a json formatted string detailing the biomes and their features. <br>
Together with SD Heightmap Generation v3.0, 3d terrain can be procedurally generated.

<!-- Provide a quick summary of what the model is/does. -->

## Uses
Example Inference:<br>

    <prompt> Alpine mountains and a forest adorned with red flowers.

Result:<br>

    <prompt> Alpine mountains and a forest adorned with red flowers.<br>
    <biomes> [{'Entities': {'Boulders': [], 'BouldersSpawnrate': 0.0, 'Grass': [{'BaseTint': '#ff0000', 'Id': 'flowers'}], 'GrassSpawnrate': 0.8, 'Trees': [], 'TreesSpawnrate': 0.0}, 'Name':'Alpine Mountains', 'SpawnCondition': {'HeightRange': [0.0, 0.5], 'SlopeRange': [0.0, 0.3]}, 'Texturing': {'GroundTexture': 'grass', 'GroundTextureTint': '#7cfc00', 'SlopeTexture': 'grass', 'SlopeTextureTint': '#7cfc00'}}, {'Entities': {'Boulders': [], 'BouldersSpawnrate': 0.0, 'Grass': [], 'GrassSpawnrate': 0.0, 'Trees': [{'BaseTint': '#8b4513', 'Id': 'tree_large'}], 'TreesSpawnrate': 0.8}, 'Name':'Redwood Forest', 'SpawnCondition': {'HeightRange': [0.0, 0.5], 'SlopeRange': [0.0, 0.3]}, 'Texturing': {'GroundTexture': 'dirt', 'GroundTextureTint': '#7cfc00', 'SlopeTexture':'stone', 'SlopeTextureTint': '#c2c2c2'}}]
<!-- Address questions around how the model is intended to be used, including the foreseeable users of the model and those affected by the model. -->

Requires ~3GB VRAM
Training Loss: 4%
Validation Loss: 6%

## Bias, Risks, and Limitations

Model is biased to certain ids like: 
* textures: grass, dirt, mud, mud_dry, stone, stone_smooth
* boulders: boulder_small, boulder_medium, boulder_large
* trees: tree_small, tree_medium, tree_large, tree_conifer_small, ...
* grass: grass_small, grass_medium, grass_large, grass_dry, flowers

Model also has trouble overadjusting tints, leading to oversaturated colorations.
Model sometimes continues output. Just end prompt at "}}]".
Model sometimes creates incomplete biome definitions or places entities on wrong biome.
<!-- This section is meant to convey both technical and sociotechnical limitations. -->

## Model Details
Finetuned on custom dataset of size 538 json formatted biome definitions consisting of:

* Name
* SpawnCondition
  * HeightRange
  * SlopeRange
* Entities
  * Trees
    * Id
    * BaseTint
  * Boulders
    * Id
    * BaseTint
  * Grass
    * Id
    * BaseTint
  * TreesSpawnrate
  * BouldersSpawnrate
  * GrassSpawnrate
* Texturing
  * GroundTexture
  * GroundTextureTint
  * SlopeTexture
  * SlopeTextureTint

### Model Description

<!-- Provide a longer summary of what this model is. -->
- **Model type:** [PEFT Adapter]
- **Language(s) (NLP):** [English]
- **License:** [Apache 2.0]

### Model Sources [optional]

<!-- Provide the basic links for the model. -->
- **Paper [optional]:** [tba]

### Framework versions

- PEFT 0.11.0