py4design.gmlparameterise module

class py4design.gmlparameterise.Parameterise(citygmlfile)

Bases: object

An object that extracts all the neccessary information from CityGML model and parameterise it.For more information please refer to Chen, Kian Wee, Patrick Janssen, and Leslie Norford. 2017. Automatic Parameterisation of Semantic 3D City Models for Urban Design Optimisation. In Future Trajectories of Computation in Design, Proceedings of the 17th International Conference on Computer Aided Architectural Design Futures, pp 84 to 100. Istanbul, Turkey.

Attributes

citygml	(pycitygml.Reader class instance) The reader to read the CityGML.
parm_obj_dict_list	(list of dictionaries) Each dictionary has keys {“parameter_object”, “parameter_count”}. The parameter_object contains a BaseParm class instance for parameterising the model, and the parameter count is a tuple of ints that specify the index of the parameters used for generating a design alternative.
nparameters	(int) The number of parameters for the model.

add_parm(parm_obj)

This function adds BaseParm object for the parameterisation.

Parameters:

parm_obj : BaseParm class instance

The BaseParm for parameterising the model.

define_nparameters()

The function determines the total parameters for the model.

generate_random_parameters()

The function generates a list of random parameters.

Returns:

parameter list : list of int/floats

List of normalised parameters.

generate_design_variant(parameters, dv_citygml_filepath)

This function defines generates a design alternative based on all the appended parameter objects.

Parameters:

parameters : list of ints/floats

The normalised parameters to be mapped to the real parameters defined, the parameters will be used to generate a design alternative.

dv_citygml_filepath : str

The file path of the CityGML file to write the generated design alternative.