Urb version 0.01
================

Urb - Urban structures

A perl framework for modelling and transforming buildings and other urban
structures.  Specifically an 'informal layout' form language is used that is
complementary with the pattern language described by Christopher Alexander.
Tools are provided for mutation/evolution/adaptation directed by a fitness
function that selects using Alexander's patterns as fitness criteria.

Urb is part of the Homemaker suite of tools

For usage, see the pod documentation included with the source code.

This is EXPERIMENTAL software, expect it to be slow, incomplete or broken.

QUICKSTART

Evolve an example structure, this may take some time:

  cd examples/sixteenth/00
  urb-evolve.pl init.dom

INSTALLATION

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

DEPENDENCIES

This module requires these other perl modules and libraries:

   Test::More
   Graph
   SVG
   YAML
   Math::Polygon
   List::Util
   Test::Pod
   ExtUtils::MakeMaker
   File::Copy
   File::Spec
   File::Temp
   Math::Trig
   Algorithm::Evolutionary

Some other standard utilities are used in various places:

   make
   coreutils
   gzip
   sed
   graphviz

CREATING 3D MODELS OF GENERATED BUILDINGS

The dom2dxf.sh script will assemble a 3D DXF, IFC or Collada model representing a
single building, however you will need three additional perl modules, these can
be retrieved from Bitbucket:

   File::IFC
   File::DXF
   Molior

COPYRIGHT AND LICENCE

Copyright (C) 2004-2020 by Bruno Postle <bruno@postle.net>

This file is part of Urb.

Urb is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

Urb is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with Urb.  If not, see <http://www.gnu.org/licenses/>.