Releases: SpaceGroupUCL/depthmapX
Release list
depthmapX v0.9.1
This maintenance release restores legacy Penn measures, corrects axial normalisations, and improves macOS release packaging.
Analysis fixes
- Restored
Metric Step Penn Distancein VGA metric step-depth analysis. - Restored
Metric Mean Penn Distancein VGA metric analysis. - Restored Penn-distance attributes when converting legacy graph files.
- Corrected axial
Integration [P-value]to use the pyramid P-value normalisation instead of duplicating the D-value/HH calculation. - Corrected
RA [Penn]to use the actual maximum shortest-path depth. - Hardened the Penn palm-tree normalisation for invalid and out-of-range inputs.
- Preserved unavailable legacy Penn values and prevented negative detour distances.
- Added regression tests covering the restored measures and corrected formulas.
macOS and release packaging
- Re-signed macOS application bundles after deployment to prevent macOS reporting them as damaged.
- Added checks for invalid signatures and remaining Homebrew library links.
- Improved release reruns so existing release notes are preserved while assets are replaced.
Compatibility note
@varoudis :
Be careful! Axial Integration [P-value] and some RA [Penn] results may differ from earlier releases.
Previous versions calculated P-value integration using the D-value formula and could use an incorrect maximum depth for Penn normalisation.
Downloads
macOS ships as two builds. The Apple Silicon binary will not run on an Intel Mac,
so pick the one matching your machine. The depthmapXcli_* files are the
command-line tool.
Opening depthmapX on macOS
depthmapX is not signed with an Apple Developer ID, so macOS blocks it the first
time. The app is unmodified — it simply has no paid Apple signature.
- Double-click depthmapX. macOS refuses and offers only Done or Move to
Bin — click Done. - Open System Settings → Privacy & Security and scroll to Security. You
will see "depthmapX" was blocked to protect your Mac. Click Open Anyway. - Confirm Open Anyway and authenticate if prompted.
You only need to do this once. On macOS 14 and earlier, right-clicking the app
and choosing Open works instead.
If you prefer the terminal:
xattr -dr com.apple.quarantine /Applications/depthmapX.app
Full Changelog: v0.9.0...v0.9.1
depthmapX v0.9.0
The first release since 0.8.0 (November 2020). It collects the 2020–21 work that
was never released, fixes two bugs that produced wrong results or crashes, and
ships native binaries for four platforms.
Have fun all and test if you can as there are a number of old changes/fixes! ( @varoudis )
If you use subtraction in SalaScript on macOS or Linux, see the first item —
affected analyses should be re-run.
Fixed
- SalaScript subtraction returned the negated result on macOS and Linux:
5 - 3gave-2. The operands were evaluated in an order C++ leaves
unspecified, and both clang and gcc picked the one that flips the sign. Every
macOS and Linux build to date is affected. - Converting a map from a zero-width or zero-height region divided by zero
and attempted a ~51 GB allocation, crashing or exhausting memory depending on
platform. Such regions are now rejected with a clear message. - Map conversion stored indices instead of refs, corrupting the result.
- Line height is now taken as an absolute difference.
- Clicking an invalid pixel no longer crashes when its shapes are requested.
- The displayed data map can no longer go negative.
- The Windows build works with current MSVC again; a custom
log2collided
with the compiler intrinsic and is nowpafLog2. The MinGW build is also
fixed.
Added
- Binaries for four platforms, GUI and command line, built and tested
automatically for every release. - Line transparency is honoured where it has been provided.
- Shapegraph links and unlinks can be exported.
- A modular CMake build, with generalised build directories.
- Continuous integration on Linux, macOS and Windows. The previous service
had been shut down for years, so nothing had been checked automatically since
2020.
Changed
- Entropy values may differ in the last bit. As a side effect of the
pafLog2rename, entropy now uses depthmapX's own base-2 logarithm
everywhere; macOS and Linux previously used the compiler's built-inlog2
silently. About 27% of inputs differ, by at most one double-precision epsilon
(2.2e-16). Conclusions are unaffected, but final digits can move. - The isovist angle dialog no longer appears when a full isovist is requested,
and data maps are hidden while isovists are being created. - Agent steps and field of view accept whole numbers only.
Downloads
macOS ships as two builds. The Apple Silicon binary will not run on an Intel Mac,
so pick the one matching your machine. The depthmapXcli_* files are the
command-line tool.
Opening depthmapX on macOS
depthmapX is not signed with an Apple Developer ID, so macOS blocks it the first
time. The app is unmodified — it simply has no paid Apple signature.
- Double-click depthmapX. macOS refuses and offers only Done or Move to
Bin — click Done. - Open System Settings → Privacy & Security and scroll to Security. You
will see "depthmapX" was blocked to protect your Mac. Click Open Anyway. - Confirm Open Anyway and authenticate if prompted.
You only need to do this once. On macOS 14 and earlier, right-clicking the app
and choosing Open works instead.
If you prefer the terminal:
xattr -dr com.apple.quarantine /Applications/depthmapX.app
Thanks to @pklampros and @blsemo for the 2020–21 work included here.
depthmapX v0.8.0
General:
- Allow for pushing values from shapemaps (axial maps, segment maps) to VGA
- Fix VGA map connections export
- Make drawing to segment conversion faster
- Test and fix shape removal for axial and data maps
- Allow pushing the Ref or Key value to another layer
- Fix MIF/MID import (allow for empty columns, PR #369)
- Fix diagonal line handling on VGA map fill (PR #326, thanks Piotr Piastucki!)
- Change C++ standard to 17
Graphical User Interface (GUI):
- Highlight shapes and pixels on hover (can be disabled in the settings)
- Allow inserting any number in the table (PR #356)
- Fix a case where the app would crash with multiple unlinking in VGA (PR #328)
- Fix convex map hover and selection (PR #368)
- Allow generating multiple isovists by importing a CSV file
- Fix a case where VGA progress bar would end, but analysis would still be going (PR #323)
- Fix tableview display (When an attribute is selected from the index, the table is sorted by the same column. When a column is sorted at the table it is also selected on the attribute index)
- Update the Map display to be visible through Remote desktops (PR #379)
- Make sure the correct tool is actually selected when creating a new file (PR #349)
- Set the minimum macOS/OSX version to 10.9
- Add icons to macOS bundle
- Add icons to the linux AppImage
- Fix convex/axial map linking
Command-Line Interface (CLI):
- Allow for printing analysis progress
- On error do not display whole help text
- Allow importing to a datamap (preserving attributes)
- Allow unmerging pixels
- Allow for weighted axial analysis
- Let the user know when a radius list is required for axial analysis
Minor bugs and fixes not included, but may be found here: https://github.com/SpaceGroupUCL/depthmapX/milestone/4?closed=1
depthmapX v0.7.0
This is a quite significant release as the internals of the application have been modernised making it more future proof and easier for new developers to access and contribute. With this release depthmapX will also be more robust and not crash as often as previous releases when handling different data and analyses. More details about user-facing changes can be found here and internal changes here
A more full list of changes can be seen in detail here
For macOS users still on version 10.13 try this build
depthmapX v0.6.0
For windows you may need to also install the Visual C++ Redistributable for Visual Studio 2015
Changes:
- Changed the main map window to one using OpenGL
- Removed idepthmap, idepthmapx and gmlmap
- Allowed dxf to parse blocks of in deep hierarchies (block within a block, blockception)
- Removed paftl from dxf, p2dpoly and pafmath
- Created tests for dxf parsing
- Forced agent analysis with occlusion look to prompt for isovist analysis first
- Made the EPS export scale optional
- Provided a new preferences dialog
- Allowed opening empty graphs
- Allowed selecting the "Ref" attribute
- Various object deletion fixes
- Fixed Save As..
- Created an axial, isovist, agents and export options for the cli
- Allowed exporting pointmap, axial and segment connections
- Removed pstring and plist
- Fixed table view scrolling for mac
- Fixed depthmapView for mac
- Provided the automatic building and uploading scripts (client and server)
- Provided regression tests for isovists and axial lines analysis
depthmapX 0.55 beta
Transferred from https://github.com/blackseamonster/depthmapX/releases/tag/v0.55beta
Dev beta release of depthmapX in progress - this version has some issues fixed but is functionally very similar to previous versions of depthmapX. See https://github.com/blackseamonster/depthmapX/wiki/Changelog for changes.
Install by downloading the appropriate zip file for your platform and unpacking to the local hard drive - they should contain everything you need to run the app.
Changes:
- Fixed some internal memory/runtime issues
- Import links from file
- Fixed crash on zoom-out issue
- command line app (depthmapXcli)
- restructured the code base to have more libraries that can be tested and reused
- added catch as unit test framework
- made simple mode option persistent
- fixed persistence of user options on Windows
- fixed mouse wheel zoom (center on mouse pointer, not center of the map)