Dear All,

I want to develop a plugin for DepthMap to analyze targeted visibility as a part of my Ph.D. dissertation. I could only find Salascript Manual written by Alasdair Turner in 2007 as a guide. Another link that explains Salascript (http://www.vr.ucl.ac.uk/depthmap/) was removed. I would be grateful if you could recommend me any other sources that explain Salascript and the IDE/platform to write code in Salascript. 

Best Regards,
Gizem Yenel 

亲爱的(论坛里的）所有人,

我想开发一个DepthMap插件来分析目标可见性，作为我博士论文的一部分。我只能找到Alasdair Turner在2007年写的《Salascript手册》作为指南。另一个解释Salascript (http://www.vr.ucl.ac.uk/depthmap/)的链接被删除。如果你能给我推荐任何解释Salascript和IDE/平台在Salascript中编写的代码的其他资源，我将非常感激。

最好的问候,

Gizem Yenel

Dear Gizem,

Can you please clarify what you mean by "targeted visibility"? There might be ways to do what you're after without resorting to Salascript, and I'd be happy to help if I can, (I worked with VGA in my own Ph.D.).

While Salascript is indeed still a part of depthmapX, I don't think you could consider it to be a fully-working language, let alone a fully fledged programming language, implementation and engine that has its own IDE/platform. It's primarily used to transform map attributes with simple operations for example to multiply the isovist area by 1550 to get square inches from square metres. If you are intending to do something similar then you can do this by creating a new attribute in your map, right clicking on the attribute and "Update column". I think there might be ways to run Salascript outside this scope, but none comes to mind now.

Regardless; Judging from the archived version of the page you sent, the file you're looking for is salascript.pdf which you may also find here. Beyond these resources there's a part of the testing suite that you can check for examples, most of which were adapted from Alasdair Turner's examples, but also a recent paper by João Lopes, Alexandra Paio and José Nuno Beirão where the authors explain some particularities about using it. If you really, really, really want to use Salascript then IMHO the best person to talk to would be the first author of that paper (João Lopes) as he's the only person I've seen using it extensively.

If you want to discuss this in more detail you can always find us (the depthmapX maintainers and some users) on matrix on the channel depthmapX-users.

Hope this helps!

Cheers,
Petros

亲爱的Gizem,

你能解释一下你所说的“目标能见度”是什么意思吗?也许有一些方法可以在不使用Salascript的情况下完成您所追求的内容，如果可以的话，我很乐意提供帮助，(我在自己的博士学位中研究过VGA)。

虽然Salascript确实仍然是depthmapX的一部分，但我认为你不能认为它是一种完全工作的语言，更别说是一种拥有自己的IDE/平台的成熟编程语言、实现和引擎了。它主要用于通过简单的操作来转换地图属性，例如将isovist区域乘以1550以得到平方英寸。如果您打算做类似的事情，那么您可以通过在映射中创建一个新属性来实现，右键单击属性和“Update列”。我认为可能有方法在这个范围之外运行Salascript，但现在没有想到。

不管怎样;从你发送的存档版本来看，你正在寻找的文件是salscript .pdf，你也可以在这里找到。除了这些资源之外，还有一部分测试套件可以供您查看示例，其中大部分改编自Alasdair Turner的示例，但也有一篇由João Lopes、Alexandra Paio和José Nuno Beirão最近发表的论文，其中作者解释了使用它的一些特殊之处。如果你真的、真的、真的想使用Salascript，那么在我看来，最好的交谈对象应该是那篇论文的第一作者(João Lopes)，因为他是我见过的唯一一个广泛使用它的人。

如果你想更详细地讨论这个问题，你总是可以在频道depthmapX-users上找到我们(depthmapX维护者和一些用户)。

希望这可以帮助!

祝福,

佩特

Dear Gizem

Do you mean by 'targeted visibility' something like partial isovist or directed isovist which is limited by an angle of vision, like 180 degree?

If so, and if you don't mind using another tool but DepthMap, I can show you a way.

There is an analysis tool named SaVisibilityUtd, which implements original isovist, directed isovist, isovist along path, VGA, VAE, etc.

You can download the tool at my blog. https://ladonara.blogspot.com

I hope that helps.

Regards,

Minseok Kim

亲爱的Gizem

你说的“目标可见性”是指像局部的isovist或定向的isovist，即受限于一个视角，比如180度?

如果是这样，如果您不介意使用除DepthMap之外的其他工具，我可以向您提供一种方法。

有一个叫做SaVisibilityUtd的分析工具，它实现了original isovist, directed isovist, isovist along path, VGA, VAE等。

你可以在我的博客上下载这个工具。https://ladonara.blogspot.com

我希望这对你们有所帮助。

问候,

Minseok Kim

Dear Petros, Thank you so much for your detailed answer and the sources that you provide. By the way, I still cannot access to the pdf on the link (https://web.archive.org/web/20090305063732/http://www.vr.ucl.ac.uk/depthmap/scripting/manual.html) that you provide. It says: this page is not available on the web because of server error. I mean by targeted visibility something like partial isovist that is determined by an angle of vision. For targeted visibility, specific visual targets are defined and examined to decide which visual targets are visible from each location in a setting. As I know, DepthMap produces only generic visibility analysis that deals with all parts of a space. Therefore, according to the targeted visibility definition, I formulated how targeted visibility will be calculated in DepthMap. For this calculation, I mostly use commands that already exist in DepthMap like isovist area and agent analysis. However, I want to use these commands partially for selected points, not for the whole plan (so this part needs to be coded). Finally, I need a division/ratio of two results (numbers) for the targeted visibility calculation (this part also needs to be coded). As I have an architectural background, I’ve just learned Python for the thesis. I don’t know C++. I thought that I need to continue coding in Salascript since DepthMap is written in Salascript. According to my situation, which programming languages and IDE/platform do you suggest for me?

Best Regards,

--

亲爱的佩特,

非常感谢您详细的回答和提供的信息来源。

顺便说一下，我仍然无法访问你提供的链接(https://web.archive.org/web/20090305063732/http://www.vr.ucl.ac.uk/depthmap/scripting/manual.html)上的pdf。它说:由于服务器错误，这个页面在网络上不可用。

我的意思是目标可见性，就像部分isovist，是由一个视角决定的。对于目标可见性，定义并检查特定的可视目标，以决定在设置中的每个位置中哪些可视目标是可见的。据我所知，DepthMap只生成处理空间所有部分的通用可见性分析。因此，根据目标可见性定义，我制定了如何在DepthMap中计算目标可见性。对于这个计算，我主要使用DepthMap中已经存在的命令，如isovist area和代理分析。然而，我想将这些命令部分用于选定的点，而不是整个计划(因此这部分需要编码)。最后，我需要两个结果(数字)的分割/比例，用于目标可见性计算(这部分也需要编码)。

因为我有建筑学背景，所以我只是为了这篇论文学了Python。我不懂c++。我认为我需要继续在Salascript编码，因为DepthMap是写在Salascript。根据我的情况，你建议我使用哪种编程语言和IDE/平台?

最好的问候,

Gizem Yenel博士候选人

室内建筑与环境设计系

肯特大学

安卡拉,土耳其

Dear Minseok, Yes, I mean partial isovists. Following targeted visibility analysis, I have some additional steps to follow. Therefore, I don’t know this tool will be a solution to my problem, but I will definitely download and try it.

Thank you so much!

Best regards,

--

Gizem Yenel, Ph.D. CandidateDepartment of Interior Architecture and Environmental DesignBilkent UniversityAnkara, Turkey

亲爱的Minseok,

是的，我指的是局部的isovist。在完成目标可见性分析之后，我还需要执行一些额外的步骤。因此，我不知道这个工具将解决我的问题，但我一定会下载并尝试它。

非常感谢!

最好的问候,

Gizem Yenel博士候选人

室内建筑与环境设计系

肯特大学

安卡拉,土耳其

Dear Gizem,

Petros is right: Salascript is meant to do some (more or less complex) scripting in a “pythonesk” style. If you want to develop a real plugin for DepthMap maybe the best is to get involved in its development (see Petros reply).

In the paper Petros refers (you can find it here http://papers.cumincad.org/data/works/att/ecaadesigradi2019_159.pdf)  I´ve used Salascript in a fairly complex way (implementing visibility Revelation related measures). You can find some details there, because I felt compelled to register them for the lack of references to its use. The scripts run inside Depthmap in the “update column” window and stays attached to that column. Things run in a semiautomatic fashion… 

In general, for VGA visibility analysis, and in your case, the process boils down to gain access to the relative x,y position of the points through the “Ref Number” column and to use analytic geometry/trigonometry to introduce distances, angles and ranges.

Give it a try but be prepared for a process of trial and error… patience and persistence pay off in the end.

Best regards,

João Ventura Lopes, Ph.D. Candidate
ISCTE - University Institute of Lisbon
Lisbon, Portugal

亲爱的Gizem,

Petros是对的:Salascript的目的是用“pythonesk”的形式编写一些(或多或少复杂)脚本。如果你想为DepthMap开发一个真正的插件，也许最好是参与到它的开发中去(参见Petros的回复)。

在Petros的文章中提到(你可以在这里找到它http://papers.cumincad.org/data/works/att/ecaadesigradi2019_159.pdf)，我以一种相当复杂的方式使用了Salascript(执行可见性启示相关的措施)。你可以在那里找到一些细节，因为缺乏使用它的参考,我觉得必须登记它们。这些脚本在Depthmap的“更新列”窗口中运行，并一直附加在该列上。一切都是半自动的。

通常，对于VGA可见性分析，在您的情况下，过程可以通过“Ref Number”列获得点的相对x、y位置，并使用解析几何/三角学来引入距离、角度和范围。

试一试，但要做好反复试验的准备，耐心和坚持最终会有回报。

最好的问候,

João文图拉·洛佩斯博士候选人

里斯本大学研究所

葡萄牙里斯本

Dear Gizem

Do you think of some visual targets and visual surroundings around them in a specified angle of vision?

Possibly, VAE(Visual Access & Exposure) Model by J.J. Archie can be one of the nearest.

SaVisibilityUtd implements the model as well as isovist and VGA.

But, I'm not sure there is any paper available online about VAE.

Agent Visibility Model can be another.

The paper dealing with that model is as below.

Lim L, Kim M, Zimring C, Measuring Interpersonal Visual Relationships in Healthcare Facilities: The Agent Visibility Model and SAVisualPower Tool, HERD, 12(4), 2019.

SaVisualPower application implements the model, which you can get through Lim L (first author of the above paper).

Good luck to you.

Regards,

Minseok Kim

亲爱的Gizem

你会在特定的视角下想到一些视觉目标和周围的视觉环境吗?

也许，J.J. Archie的VAE(Visual Access & Exposure)模型是最接近的。

SaVisibilityUtd实现了模型以及isovist和VGA。

但是，我不确定网上是否有关于VAE的论文。

代理可见性模型可以是另一个。

处理该模型的论文如下。

 Lim L, Kim M，Zimring C，医疗机构人际视觉关系的测量:代理可见性模型和SAVisualPower工具，中国，2019,12(4)。

SaVisualPower应用程序实现了该模型，您可以通过Lim L(上述论文的第一作者)获得该模型。

祝你好运。

问候,

Minseok金

Dear João,

I will read your paper to understand Salascript more and I will also search for other ways to develop a plugin for DepthMap. I know it won’t be an easy process but I will do as much as I can. 

Thank you for taking the time to reply to my email.

Best Regards,

--

Gizem Yenel, Ph.D. Candidate
Department of Interior Architecture and Environmental Design
Bilkent University
Ankara, Turkey

亲爱的Joao,

我将阅读你的论文，以了解更多的Salascript，我也将寻找其他方式来开发一个插件的DepthMap。我知道这不是一个简单的过程，但我会尽我所能。

感谢您花时间回复我的邮件。

最好的问候,

Gizem Yenel博士候选人

室内建筑与环境设计系

肯特大学

安卡拉,土耳其