Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

No documentation on values end1 and end2 in the Links Agent Monitor #2229

Open
brandesNW opened this issue Mar 15, 2024 · 1 comment
Open

Comments

@brandesNW
Copy link
Contributor

In the Links Monitor how does one specify end1 and end2?
These are turtles, and the most obvious values to try are who numbers e.g. 0 or expressions using who numbers e.g. (turtle 0).

As indicated below neither of these works.

The documentation does not help. It gives an example for a patch but not for a link. It indicates that you can open agent monitors through the Tools menu or the inspect command.
The inspect documentation gives the example

inspect one-of links
;; an agent monitor opens for a random link

Create a Links Agent Monitor
Directions
Create two turtles
Create a link between them
Execute inspect link 0 1 in the command center

The monitor looks like this:
Link Monitor

You might think that if you open a new Link Monitor and type (turtle 0) and (turtle 1) for end1 and end2 that would work.
However if you type (turtle 0) for end 1 and Return the value will disappear, which is how Agent Monitors generally work.
If guided by inspect link 0 1 in the documentation you enter 0 for end1, you get a runtime error. This is clearly an issue that needs to be fixed.

Has this feature ever worked? How is it supposed to work?

@LaCuneta
Copy link
Contributor

With the merger of #2231 the behavior here is improved. As noted, you can now type turtle who numbers into the end1 and end2 fields, along with a link breed, and it will show the desired link. However this is what you see before specifying the breed:

Link Monitor - no breed specified

This looks at a quick glance like it's a valid link, which might be confusing for users. I think that if a user types in two turtle numbers and a link exists between them, one of those links should be chosen and displayed. This matches how the patch monitor works, where entering a pxcor will pick and display one of the patches with that coordinate and allow the user to further refine (say, by pycor) if they want to afterwards.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants