Jonny00's picture
Update README.md
fee9962 verified
metadata
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.
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.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'}}]

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.

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]

Framework versions

  • PEFT 0.11.0