Professional Documents
Culture Documents
Figueiredo 2005 - Space Syntax Software (English)
Figueiredo 2005 - Space Syntax Software (English)
0
Space Syntax Software
Citations
Figueiredo, L., 2005, Mindwalk 1.0 Space Syntax Software, Laboratrio de Estudos
Avanados de Arquitetura LA2, Universidade Federal de Pernambuco, Recife.
Available at:
http://www.mindwalk.com.br/papers/Figueiredo_2005_Space_Syntax_Software_en.pdf
Copyright Lucas Figueiredo de Medeiros All rights reserved.
PRESENTATION
Thank you for the interest expressed in Mindwalk, a new application to perform
spatial analysis on buildings and cities over axial (Hillier and Hanson, 1984) and
continuity maps (Figueiredo, 2004, 2005; Figueiredo and Amorim, 2004, 2005). It
imports and exports maps as drawing exchange files (DXF) and simple coordinate
files (text files), being able to create continuity maps by aggregating axial lines
in a traditional axial map. Mindwalk supports all standard syntactic measures,
a version of the choice measure and new ones associated with the continuity
system. It was fully written in Java, a programming language designed to be
platform-independent by using virtual machines.
Most of Mindwalk was written in 2002 under code name xSpace (Axial Space),
software primarily designed to support our research on continuity lines. Since
then, the absence of a definitive tool for spatial analysis, particularly on a
PC platform, supported a growing search for our software. In 2004, xSpace
was adopted as a tool for teaching space syntax in class context at the Taubman
College of Architecture and Urban Planning - University of Michigan, USA, and at
University of Brasilia and Federal University of Pernambuco, both in Brazil. Such
experiences provided an important feedback and encouraged us to distribute our
software worldwide.
Mindwalk, version 1.0, is being distributed for academic and non-commercial
purposes (see the licence agreement for details). This version no longer still
under development and it is freely provided without any support or warranty of
any kind. It may not be fully functional and it may not be fully compatible with
other tools. Despite these limitations, Mindwalk is a versatile and easy to use
application and it is expected to be a useful tool for the space syntax
community. To get the latest information about Mindwalk, go to our site at
http://www.mindwalk.com.br.
Mindwalk is now being revised. It is an opportunity for you to ask any questions
or suggest any improvements or corrections in future versions. You can also help
our research on continuity lines by sending axial maps of cities. We are
interested in any kind of technical cooperation. Send an e-mail, there will be a
reply as soon as possible.
Enjoy!
Lucas Figueiredo
lucasfigueiredo@gmail.com
MSc in Urban Development
Acknowledgments
The production of this documentation was supported by Fundao de Amparo
Cincia e Tecnologia do Estado de Pernambuco FACEPE, and coordinated by
Professor Luiz Amorim, from the Laboratrio de Projetos do Departamento de
Arquitetura e Urbanismo da Universidade Federal de Pernambuco - UFPE.
We would like to thank Professors Luiz Amorim, Frederico de Holanda e
Guilherme Varela, who provided important feedback.
Mindwalk includes software developed by the JDOM Project http://www.jdom.org
SUMMARY
Presentation........................................................................................................... i
Summary .............................................................................................................. ii
Licence Agreement..................................................................................................iv
Getting Started ...................................................................................................... 1
1. Installing the Java ............................................................................................ 1
Installing over the Web ...................................................................................... 1
Manual download ............................................................................................. 1
Mac OS .......................................................................................................... 1
2. Running the software ........................................................................................ 1
Running from the command line ........................................................................... 1
Getting more memory........................................................................................ 1
3. Troubleshooting ............................................................................................... 2
Loading Maps ......................................................................................................... 2
1. Simple coordinate files ...................................................................................... 2
2. DXF Files........................................................................................................ 3
Layer organisation ............................................................................................ 3
3. Building the graph ............................................................................................ 3
Dealing with disconnect lines ............................................................................... 3
Unlinking two lines ........................................................................................... 4
4. Continuity maps............................................................................................... 4
5. Troubleshooting ............................................................................................... 4
Performing Spatial Analysis ........................................................................................ 5
1. Standard measures ........................................................................................... 5
Connectivity ................................................................................................... 5
Control.......................................................................................................... 5
Depth ........................................................................................................... 5
Global integration ............................................................................................ 5
Local integration.............................................................................................. 6
Radius-radius integration .................................................................................... 6
Fast choice..................................................................................................... 6
2. Advanced measures........................................................................................... 6
Intelligibility and synergy.................................................................................... 6
Length .......................................................................................................... 6
Sinuosity........................................................................................................ 6
Aggregation degree........................................................................................... 6
Reserved ....................................................................................................... 7
Exporting data ....................................................................................................... 7
1. The table window............................................................................................. 7
ii
iii
LICENCE AGREEMENT
SOFTWARE LICENCE AGREEMENT FOR ACADEMIC AND NON-COMMERCIAL USE
DEFINITIONS
(a) Software means Mindwalk, in binary form, any other machine-readable materials
(including, but not limited to, libraries, source files, header files and data files) and any
documentation provided to You under this Agreement.
(b) Author means the author and copyright owner of the Software: Lucas Figueiredo de
Medeiros.
(c) You (or Your) means an individual or legal entity exercising permissions granted by this
Agreement.
(d) Licence (or Agreement) means the terms and conditions defined by this document.
PLEASE READ THE TERMS AND CONDITIONS OF THIS AGREEMENT CAREFULLY. BY INSTALLING OR
USING THE SOFTWARE, YOU ACCEPT THE TERMS AND CONDITIONS OF THIS AGREEMENT. THE
TERMS AND CONDITIONS OF THE AGREEMENT UPON YOU CAN USE THE SOFTWARE ARE AS
FOLLOW:
1. The Purpose of the Software. Your use of the Software will be exclusively for academic and noncommercial purposes. Under this Agreement, You also agree that services offered by individuals or
legal entities, including but not limited to teaching and consulting services, are commercial
purposes, even if any profit may be reverted for academic or non-commercial purposes.
2. Distribution. This licence is not transferable. You will not transfer, sell, rent, resell or distribute
the Software. You will not make copies of the Software except for Your personal and normal use or
for the purpose of backup. Each individual or legal entity must acquire the Software directly from
the Author.
3. Copyright. The Software is an intellectual property of the Author. You will not disassemble,
decompile or use any kind of reverse engineer on it. You will not adapt, modify or create derivative
works based on the Software or any part of it without prior written permission of the Author.
4. Disclaimer of Warranty. You acknowledge that the Software is experimental and is supplied to
You on "AS IS" basis, without any technical support or warranty of any kind, either express or
implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT,
MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for
determining the appropriateness of using the Software and assume any risks associated with Your
exercise of permissions under this Licence.
5. Limitation of Liability. In no event and under no legal theory, whether in tort (including
negligence), contract, or otherwise, shall the Author be liable to You for damages, including any
direct, indirect, special, incidental, or consequential damages of any character arising as a result of
this Licence or out of the use or inability to use the Software (including but not limited to damages
for loss of goodwill, loss of data, work stoppage, computer failure or malfunction, or any and all
other damages or losses), even if such Author has been advised of the possibility of such damages.
6. General Provisions. This Licence is governed by Brazilian Law and is subject to exclusive
jurisdiction of the Brazilian courts, without giving effect to principles of conflict of laws. The city of
Recife, Pernambuco, Brazil, is automatically elect as the court for any legal questions.
7. Duration. This licence is changeable by the Author at any time. This Licence is terminable by the
Author at any time OR on the first day of 2007, which will occur first.
END OF TERMS AND CONDITIONS
The Author,
LUCAS FIGUEIREDO DE MEDEIROS
iv
Part 1
GETTING STARTED
Mac OS
java jar
C:\Mindwalk_1.0\Mindwalk_1.0.jar
Getting more memory
If you are using Mindwalk to analyse large
maps (more than ten thousand lines), it is
recommended that you reserve a significant
amount of memory for Mindwalk. It can be
done through the following command line:
Chapter 2
LOADING MAPS
http://www.java.com/en/download/help
(b) Mindwalk includes software developed by
the JDOM Project (http://www.jdom.org/).
Check if the auxiliary package jdom.jar is
located
in
the
same
directory
of
Mindwalk_1.0.jar.
(c) Linux and Solaris users should check if
Mindwalk has permission to run or permission
to write to some files and directories (a
message will probably appear).
(d) This release was build with Java 1.4.2_08
and it was also tested on Java 1.5.0_03. New
updates
may
create
unexpected
incompatibilities. In this case, you must check
our site for more information.
(e) I have never tested Mindwalk on Mac
environments. You may encounter unexpected
errors.
2. DXF Files
DESCRIPTION
Line
Standard 2D
Line (Axial
Line)
Polyline
Standard 2D
Polyline
(Continuity
Line)
Mindwalk 1.0
does not support
lightweight
polylines
(LWPolyline)
Circle
Standard 2D
Circle
Marks an invalid
intersection
Text
Single line
text
Mindwalk uses a
default font
LAYER
CONTENT
SAMPLES
Axial*
Axial or
continuity
lines
Axial1,
AxialCentre
Continuity* Axial or
continuity
lines
Unlink*
Circles
representing
unlinks
Other
layers
Background
drawings
NOTES
Continuity1,
ContinuityRoads
Unlink1,
UnlinkBridges
4. Continuity maps
Mindwalk 1.0 does not only work with axial
maps (Hillier and Hanson, 1984) but also with
continuity maps (Figueiredo, 2004; Figueiredo
and Amorim, 2004, 2005). In few words, a
continuity line ignores changes of direction up
to a limit to represent an urban path in its
maximum extension. This model seems to be
closer to the way we experience the urban
grid during long journeys since continuity
lines
are
easily
recognised
through
movement. Mindwalk simulates continuity
lines as polylines, calculating correctly the
intersections between both axial and
continuity lines.
Note:
Tips:
(a) This procedure works normally on
continuity maps. You are able to continue
aggregating with wider angles;
(b) We call an aggregated axial map
continuity map. You should include the
angle by which you have created your map, for
example, Continuity Map, 35;
(c) The angle 35 works well for most types of
urban grids (Figueiredo and Amorim, 2005);
Your original map will be lost after the
aggregation procedure. Use the Save As
option from the File menu to save your
continuity map to a new file.
5. Troubleshooting
(a) It is strongly recommended you make a
backup of your original drawing before using
Mindwalk.
(b) Is the graph empty? Put your lines in a
layer beginning with Axial or Continuity.
Otherwise they will not be recognised as a part
of your graph.
ci = 1
Part 3
PERFORMING SPATIAL ANALYSIS
i j
Control
This measure represents the degree to which a
line i controls the access from and to the
lines j directly connected to it.
ctrli =
i j
1
cj
Depth
Depth is the topological distance of a line i
from a given line j through the shortest path
between them. Each line in this path counts
one topological step as the following
manner:
1. Standard measures
d i = d ij
Depth can be calculated from any line in the
system, depth from. But it normally refers
to the depth from the most integrated line in
the system, simply depth (see global
integration).
Global integration
Radius-radius integration
The radius-radius is equal to the mean depth
from the most integrated line in the system
and it is used as an intermediate radius
between the local and global.
MDi =
d
i j
ij
rr = MDi
k 1
Fast choice
RAi =
2( MDi 1)
k 2
RRAi =
Dk =
RAi
Dk
fchoicei =
2[k (n 1) + 1]
(k 1)(k 2)
n = log 2 (
2. Advanced measures
k+2
)
3
Ii =
n
k2
1
RRAi
Local integration
The integration of a given line i can also be
calculated for a subset of k lines which have
depth from the given line less or equal to a
given radius r. Note that the values for k
and Dk may be different for each line in the
system.
Length
Simply the length of the line normalised
between zero and one.
Sinuosity
Part 4
EXPORTING DATA
1. The table window
Clipboard options
(c) The easiest way of exporting your data is
copying the table to the clipboard and, then,
pasting it in your favourite statistical
software. This procedure was tested under
Windows and Linux environments. There are
three options: Copy All, Copy Selected
and finally, if you press the SHIFT key and then
click into Copy All, you copy only lines that
have names.
Header
(a) Each column corresponds to a measure.
There are also two columns indicating the line
id and an optional name. Double-clicking into
a column-header you order the table by the
corresponding measure, first ascending and
then descending.
Rows
(b) Each row corresponds to a line in the map.
You can only edit the line name and the
reserved measure (see advanced measures).
You can see the line names by changing the
Graphics, Label option of the View menu
(see the complete list of functions). When you
click in a line you select it in the table and in
the map. Little squares in the map help you
find the selection. You can also select a set of
rows by clicking in a row, pressing the SHIFT
key and then clicking in another row.
2. Supported formats
Legacy xSpace Files
Mindwalk can save the maps after calculation
as legacy xSpace files (XSP). In truth, it is a
zipped file (ZIP) containing both the DXF and a
XML (Extended Markup Language) with all
graph information, including all measures you
Part 5
COMPLETE LIST OF FUNCTIONS
1. File Menu
Open
Close
Closes the current map;
Save
Saves the current map. Mindwalk is able to
save your map as DXF, Legacy xSpace Files
(XSP), which also saves all analysis, and text
files (table of coordinates);
Text Files
In addition to the copy to the clipboard
option, another way of exporting data is to
export the whole table to a text file (TXT).
You can do it choosing the Export option in
the Table menu, the Export, As Text or
Save As options of the File menu. This file
includes the coordinates of the axial and
continuity lines.
Save As
Saves the current map to a new file of any
supported format;
Export
Audit
Images
Exit
2. View Menu
Zoom Extends
Resizes the map to fit in the current window;
Zoom In
Increases maps size;
Zoom Out
Decreases maps size;
Layers
Shows or hides the following layers in the
current map:
8
Standard
Disconnected Lines;
Unlinks
circles
intersections;
marking
invalid
Graphics
Configures all graphics properties:
Background Colour chooses between
black and white;
Colour Scale chooses the current colour
scale to represent the measures. The
options are classic, greyscale, some
grey highlighting top values and threshold,
which highlights values greater than a base
value;
Advanced
(see advanced measures):
default
Language
3. Measure Menu
Build Graph
Builds the graph (it may take several minutes).
You must do it before performing the analysis
or the following menus still disabled;
4. Table Menu
Connectivity
(see standard measures);
Show
Control
Hide
Hides the table window;
9
REFERENCES
Export
Exports all measures and coordinates to a text
file (see exporting data).
5. Window Menu
6. Help Menu
Licence
(see licence agreement);
10