Getting Started with depthmapX: Installation and First Steps
Space syntax is a powerful framework for analyzing spatial configurations and understanding how architectural or urban layouts influence human behavior. At the heart of this methodology is depthmapX, an open-source, multi-platform software designed to perform visibility and permeability analyses. Whether you are an urban designer, an architect, or an academic researcher, this guide will walk you through the essential process of installing depthmapX and taking your very first steps with the software. What is depthmapX?
Originally developed at University College London (UCL), depthmapX allows users to analyze spatial networks at various scales. The software builds a map of open spaces into a graph, enabling you to perform:
Axial Line Analysis: To understand urban integration and pedestrian movement.
Segment Analysis: For highly detailed, metric-based angular routing.
Visibility Graph Analysis (VGA): To evaluate what can be seen from any given point within a building or urban plaza. Step 1: Downloading and Installing depthmapX
Because depthmapX is an open-source project maintained by the community, you can find the software and its source code readily available on GitHub. Windows and macOS Installation
Go to the official repository or the dedicated depthmapX release page on GitHub.
Navigate to the Releases section to find the most stable version compiled for your operating system. Download the appropriate file:
Windows: Download the .zip archive or installer executable. Extract the files to a preferred directory (e.g., C:\Program Files\depthmapX).
macOS: Download the .dmg file or the application zip. Drag the depthmapX application icon into your Applications folder.
Launch the software: Open the application file. Note for Mac users: You may need to bypass the security gatekeeper by right-clicking the app and selecting “Open” the first time you run it. Step 2: Preparing Your Spatial Data
Before you dive into depthmapX, you need spatial geometry to analyze. The software does not include comprehensive drafting tools, so you will typically import your layouts.
Format: The most reliable and universally accepted format for depthmapX is a 2D DXF file.
Clean Geometry: Ensure your CAD or GIS drawings are entirely clean. Lines must intersect precisely without gaps or overshoots. Duplicate or overlapping lines can cause processing errors during graph generation.
Layer Organization: Keep your boundaries, walls, or centerlines on simple, distinct layers to make importing straightforward. Step 3: Importing and Setting Up Your First Project
Once your file is ready, you can initialize your first spatial analysis workspace.
Open depthmapX and go to File > New to open a blank project window. Select File > Import and choose your prepared .dxf file.
A dialog box will appear asking for the drawing scale. Ensure your units (meters, millimeters, feet) match the original CAD canvas so that metric calculations remain accurate.
Your drawing geometry will now render on the screen as a series of gray lines. Step 4: Generating an Axial Map (Your First Analysis)
Axial maps are the foundational starting point for most urban syntax studies. Follow these steps to generate one automatically:
With your imported DXF lines active, navigate to the Map menu at the top. Select Convert Drawing Layer. Choose to convert your drawing into an Axial Map format.
Go to the Tools menu, navigate to Axial/Segment, and select Run Axial Analysis.
Keep the default parameters for your first run and click OK.
Interpret the Visuals: The software will instantly color-code your lines. By default, red lines represent high integration (spaces that are highly accessible and likely to have heavy pedestrian traffic), while blue lines signify segregated, isolated spaces. Next Steps
Congratulations! You have successfully installed depthmapX, imported a layout, and run your very first space syntax calculation. As you get more comfortable with the software, you can experiment with Visibility Graph Analysis (VGA) by drawing a grid over an interior floor plan or running Segment Analyses using metric radii to predict vehicular flow. To help you tailor your next spatial model, let me know:
What type of space are you analyzing? (e.g., a building interior, a neighborhood, an entire city)
What specific goals do you have? (e.g., predicting pedestrian traffic, checking emergency visibility, mapping retail potential)
I can provide targeted tips on setting up your grid or configuring your analysis radii.