README.md

metadata

library_name: peft
base_model: tiiuae/falcon-rw-1b
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.
Biome Definition is a json formatted string detailing the biomes and their features.
Together with SD Heightmap Generation v3.0, 3d terrain can be procedurally generated.

Uses

Example Inference:

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

Result:

<prompt> Alpine mountains and a forest adorned with red flowers.<br>
<biomes> [{'Entities': {'Boulders': [], 'BouldersSpawnrate': 0.0, 'Grass': [{'BaseTint': '#ff0000', 'Id': 'flowers'}], 'GrassSpawnrate': 0.0, 'Trees': [], 'TreesSpawnrate': 0.0}, 'Name': 'Red Flowers', 'SpawnCondition': {'HeightRange': [0.0, 0.1], 'SlopeRange': [0.0, 0.1]}, 'Texturing': {'GroundTexture': 'grass', 'GroundTextureTint': '#7cfc00', 'SlopeTexture': 'grass', 'SlopeTextureTint': '#7cfc00'}}, {'Entities': {'Boulders': [], 'BouldersSpawnrate': 0.0, 'Grass': [], 'GrassSpawnrate': 0.0, 'Trees': [{'BaseTint': '#ffffff', 'Id': 'tree_medium'}], 'TreesSpawnrate': 0.8}, 'Name': 'Mountain Range', 'SpawnCondition': {'HeightRange': [0.0, 0.7], 'SlopeRange': [0.0, 0.5]}, 'Texturing': {'GroundTexture':'stone', 'GroundTextureTint': '#ffffff', 'SlopeTexture':'stone_smooth', 'SlopeTextureTint': '#ffffff'}}]

Requires: ~8GB VRAM Training Loss: 2% Validation Loss: 4%

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.

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

• Model type: [PEFT Adapter]
• Language(s) (NLP): [English]
• License: [Apache 2.0]

Model Sources [optional]

• Paper [optional]: [tba]

[More Information Needed]

Framework versions

• PEFT 0.11.0