如何无需预存.nlogo文件从.nls文件启动NetLogo无头运行？

问题背景 #

需要搭建完全无头的NetLogo工作流，无需通过GUI创建初始.nlogo文件。当前所有资料均要求使用预先生成的.nlogo文件，希望了解是否可以直接从.nls（纯NetLogo代码文件）启动无头模式，或无需GUI生成.nlogo文件。环境为Mac OS Sonoma、OpenJDK 11、NetLogo 6.4.0。

尝试了以下最小示例，但运行时提示GO未定义：

示例代码 #

minimal.nls（GUI中可正常运行）

globals []

to go
  print "Hello World!"
  tick
end

Minimal.java

import org.nlogo.headless.HeadlessWorkspace;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.nio.charset.StandardCharsets;
import java.io.IOException;

public class Minimal {
    public static void main(String[] args) {
        HeadlessWorkspace workspace = HeadlessWorkspace.newInstance();
        try {
            // 读取NetLogo代码
            String netlogoCode = new String(Files.readAllBytes(Paths.get("minimal.nls")), StandardCharsets.UTF_8);

            // 打印代码验证
            System.out.println("NetLogo code:");
            System.out.println(netlogoCode);

            // 加载工作区
            try {
                workspace.openString(netlogoCode);
                System.out.println("NetLogo code loaded successfully.");
            } catch (Exception e) {
                System.err.println("Error loading NetLogo code:");
                e.printStackTrace();
                System.exit(1);
            }

            // 运行模拟
            try {
                workspace.command("go");
                System.out.println("Simulation ran successfully.");
            } catch (Exception e) {
                System.err.println("Error running 'go' command:");
                e.printStackTrace();
                System.exit(1);
            }

        } catch (IOException ex) {
            System.err.println("An error occurred while reading the NetLogo file:");
            ex.printStackTrace();
            System.exit(1);
        } finally {
            // 关闭工作区
            try {
                workspace.dispose();
            } catch (InterruptedException e) {
                e.printStackTrace();
                Thread.currentThread().interrupt();
            }
        }
    }
}

预期结果 #

NetLogo code:
globals []

to go
  print "Hello World!"
  tick
end

NetLogo code loaded successfully.
Hello World!
Simulation ran successfully.

实际错误结果 #

NetLogo code:
globals []

to go
  print "Hello World!"
  tick
end

NetLogo code loaded successfully.
Error running 'go' command:
Nothing named GO has been defined. at position 33 in
    at org.nlogo.core.Fail$.exception(Fail.scala:27)
    ...（省略堆栈信息）

错误原因 #

HeadlessWorkspace.openString()方法的作用是加载NetLogo模型的XML结构（即.nlogo文件的内容，包含界面定义、代码块等），而非纯NetLogo过程代码。直接传入.nls的纯代码会被当作无效的模型XML解析，导致过程和变量未被正确编译注册，因此调用go时提示未定义。

解决方案 #

方案1：直接编译加载纯NetLogo代码 #

使用HeadlessWorkspace.compile()方法替代openString()，该方法专门用于编译NetLogo代码（包括全局变量、过程定义等）：

修改后的Minimal.java：

import org.nlogo.headless.HeadlessWorkspace;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.nio.charset.StandardCharsets;
import java.io.IOException;

public class Minimal {
    public static void main(String[] args) {
        HeadlessWorkspace workspace = HeadlessWorkspace.newInstance();
        try {
            // 读取NetLogo代码
            String netlogoCode = new String(Files.readAllBytes(Paths.get("minimal.nls")), StandardCharsets.UTF_8);

            // 打印代码验证
            System.out.println("NetLogo code:");
            System.out.println(netlogoCode);

            // 编译NetLogo代码（注册变量和过程）
            try {
                workspace.compile(netlogoCode);
                System.out.println("NetLogo code compiled successfully.");
            } catch (Exception e) {
                System.err.println("Error compiling NetLogo code:");
                e.printStackTrace();
                System.exit(1);
            }

            // 运行模拟
            try {
                workspace.command("go");
                System.out.println("Simulation ran successfully.");
            } catch (Exception e) {
                System.err.println("Error running 'go' command:");
                e.printStackTrace();
                System.exit(1);
            }

        } catch (IOException ex) {
            System.err.println("An error occurred while reading the NetLogo file:");
            ex.printStackTrace();
            System.exit(1);
        } finally {
            // 关闭工作区
            try {
                workspace.dispose();
            } catch (InterruptedException e) {
                e.printStackTrace();
                Thread.currentThread().interrupt();
            }
        }
    }
}

方案2：无需GUI生成.nlogo文件 #

.nlogo本质是XML格式文件，可手动构造包含代码的最小模型XML，然后通过openString()或openFile()加载：

构造最小.nlogo内容

<?xml version="1.0" encoding="UTF-8"?>
<model>
  <interface></interface>
  <code><text><![CDATA[
globals []

to go
  print "Hello World!"
  tick
end
]]></text></code>
</model>

可以将上述内容写入文件（如minimal.nlogo），或直接在Java代码中构造该字符串，然后用workspace.openString(xmlContent)加载，之后即可正常执行go命令。

总结 #

无需依赖GUI即可搭建无头NetLogo工作流：

• 直接用compile()加载纯NetLogo代码是最简便的方式
• 若需要生成.nlogo文件，可手动构造XML格式的模型内容，无需GUI操作

内容的提问来源于stack exchange，提问作者alerone