Tinderbox Forum

How to use the Attribute Browser

(Desalegn) #7

Exactly. The problem I always have is how to see the big picture while still not losing the details.
The map can do good job: but, in a handful of notes. If the notes grow more than 50, in my experiencer, the map gets overwhelming.

(James Fallows) #8

Agree very much on this description. Les mots justes, you might say.

(Derek Van Ittersum) #9

Attribute Browser is also great for time-based organization. In my files for classes I’m teaching, I organize class notes, reading notes, assignment descriptions, etc. via the $StartDate attribute. This means class notes and reading notes for the same class session use the same StartDate. In the attribute browser, I sort by “StartDate” (instead of “DisplayName” in the screen shot above), this gives me a list of of all class sessions with the associated notes clumped together. Works great.

This lets me use map views to organize notes in a variety of ways, then return to attribute browser to know: what’s happening tomorrow? Next week? etc.

(Dominique Renauld) #10

I’m currently trying to finish a big text: a doctoral thesis I’ve been writing for several years and until the beginning of that year, I never felt the need for searching into my reading notes. I just gathered my notes in the course of my readings sessions. But now, the time came for me to search, as you say, not only for Les mots justes, but also for the right concepts and the right writings about those concepts. Indeed, if I have already put into the text of my thesis every reference I have to analyze, the writing process invites me to make some new hypothesis. Therefore, I have to search into my notes for new references. So, I use my Attribute Browser and read my list of $Tag or I launch a request and voilà. Here is a screenshot of my Attribute Browser :

(James Fallows) #11

I think we’re using this in very similar ways! Which is interesting and reassuring to see.

Notes for others considering the Attribute Browser plunge:

  • As Mark A pointed out, and as you can see in comparison of some of these screen shots, there is very impressive menu-based flexibility in what you display, and how you display it. You can choose to include items from: the entire document (so they don’t have to be all within one container, as with a map view); specific containers (for limited results); as the results of an agent-container; etc. Also you can do a kind of agent-upon-agent refinement: once you decide the range of items you would like to include, you can also create a query for each Attrib Browser view, to make sure you get only the items you are looking for. For instance: ones with a certain attribute, or within a certain range, or whatever.

  • There are also lots of display choices. You can have math-based summaries if you’re displaying numeric values – totals, averages, Min or Max values, etc. And you can sort the items within each grouping on any value you’d like – name, creation time, done/undone, anything you can assign to an attribute.

  • You can use columns to display data, and also to offer checkboxes – for instance, one for $Done or $Used.

  • I usually set up a window with several AtBr tabs, each using a different value. One will show my entries grouped by $Theme. Another, by $Chapter – where I intend to use them. Another by $Source. Then you switch among the tabs to see the same info in whatever is the most relevant way.

(James Fallows) #12

One other implication worth pointing out here. In the screenshot I posted earlier in this thread, highlighted below, you will see that the same note (“Mark Muro…”) shows up in two different groupings in this Attribute Browser view. They’re highlighted with the arrows:

That’s because $Theme is a set-style attribute that, for any given note, can have multiple values. Thus I see this note as part of the “Advance Manufacturing” theme, and also as part of “Bias of Journalism.” [A long back story here.] Main point is to illustrate the power and flexibility of these attribute browsers.

Is tinderbox the tool for the job?
(Dominique Renauld) #13

I’ve just read your post and tried your suggestion to plunge into the Set Data Types which I didn’t know. I thought I couldn’t assign several tags to my $Tag, but I didn’t see that $Tags could be set as a Set Data Type. After trying it, I notice that I can assign several tags to a note and see several notes with the same tags — as you can see on the screenshot below —, which is very useful in the case you search for multiple references for a same topic. Therefore, I’m going to rearrange a little bit my index cards. From now on, since 2011, my file is composed of several and different libraries I set over the years and my impression is very similar to what you can feel in a public library where there are, next to new computers, old note cards files! I’m very proud to work with Tinderbox.

(Mark Anderson) #14

Before AB view - and for those not using AB view - an agent would likely be used to review attribute data. It is useful to draw the distinction here from an agent. For example, were a normal agent being used in Outline+column view, the “Mark Muro” note would list only once as an agent’s design intent is to list each matching note only once regardless of the number of contexts in which it matches. There is nothing wrong with the latter, but as @JFallows explains, AB view allows extra nuance when a multi-value List or Set type attribute is the viewed. In this case, a note lists under every discrete value heading for which that note has that attribute value.

So, if AB view is showing values for $MySet a note with 4 values in $MySet would thus appear 4 times, once under each discrete value it holds, as shown below for note ‘eel’:

For this reason, when reviewing a Set or List in AB view, it can be useful to also show the attribute in column view as the latter will show all values.

(Andreas Grimm) #15

2 questions (that are likely feature requests)

1. composite-like note selection in AB

Is there a way of selecting two or more notes at the same time within Attribute Browser in order so see the text of those two or more selected notes in the view-pane?

2. stamp-like saved queries in AB

2.1. Is it possible to save queries just like one can save stamps?

2.2. Maybe – as a workaround – one could uncomment query-code not needed while other query-code is used although both reside in the “Query”-field.

Something like …

%% $Color=="red";

… while %% could serve as the uncomment-code.

Is there something like an uncomment-option in Tinderbox and if not: will there be an option like this?

(Mark Anderson) #16

Q1. At this point, I think that would be a feature request. Since inception, Attribute Browser view hasn’t supported multiple selections, possibly due to the way the main view is composed of lots of per-value sub-lists . In the past that had little effect, though of course that predated the new featutre of showing combined $Texts for the selection.

Q2.1. It is not possible to store queries, for AB view or for normal agents.

Q2.2. Action code doesn’t have commenting method.

(James Fallows) #17

This is just to reinforce Mark A’s point that the attribute browser can be very useful in showing you the range of assignments that a given item has. In Mark’s screen shot above, the items are grouped by $MySet, but $MySet is also a column in the display, so you can see multiple values for any given item.

Here is a detailed screenshot from the data base i’ve mentioned earlier. You’ll see that the items are grouped by $Theme, but $Theme is also one of the columns that’s displayed. I have expanded the field at the top of the screen to expose some of the settings – eg how I am grouping and sorting the items. The query listed as “Theme” is simply a test to select items that have some value for the $Theme attribute. (The query is simply “$Theme”.)

Other points to note: the different values in $Theme are displayed with separation by commas (though you separate them with semicolons when entering them). And, though not shown here, if there were too many values to display, the visible parts get truncated in a sensible way – and you can click on any item to see the full list.

(Brian Crane) #18

This is all pretty interesting and has me experimenting with AB. This was especially interesting:[quote=“derekvan, post:9, topic:394”]
In the attribute browser, I sort by “StartDate” (instead of “DisplayName” in the screen shot above), this gives me a list of of all class sessions with the associated notes clumped together.

I do have two questions though:

Is there a way to constrain the division of attribute values or do they subdivide by fixed rules? For example:

  • sorting by $Name, is it possible to have the groupings break into the alphabet (A, B, C, D…) rather than discrete string values?
  • sorting by a numerical attribute, is it possible to set the range of values for a grouping?

(Mark Anderson) #19

In both cases the answer is no:

  • String-based (single and multi-value) sort on individual values in A-Z order (case-sensitive: A,B,a,b not A,a,B,B).

  • Number-based sort on value, ascending sort order by default. Optionally, the use my set a number N in the ‘bins’ box. This divides the min-max value spread into N equally sized bins. Note this means bin divisions may thus not be at integer values. If using bins, you can’t exert finer control to set the bin sizes/borders or set a max or min cut-off for binning (e.g. to differently sized bins ignoring outliers. The ‘bins’ box only shows (to the right of ‘action’) is the selected attribute is Number-type. I suspect better binning control is a feature request yet to be made by those who really need it.

(Lewis Ulman) #20

When I wish to add a comment to action code—typically to remind myself later what I was trying to do—I create a comment attribute (e.g., $nb) and redefine as necessary to add new comments.

(Mark Anderson) #21

The last relates to here and here up-thread. In the same vein, if you use the built-in ‘Code’ prototype, or roll your own, for styling ‘code notes’ a previous convention has been to make a user String-type attribute $CodeComment and add it as a KA to the prototype. This puts the explanatory text above the $Text space.

(Jan Barth) #22

You can do so with some additional work:

  1. In the prototype for the notes that you want to group, create a user attribute that holds the text by which you want to group – e.g., $Initial.

  2. In the agent which contains the notes, create an action that populates the attribute – e.g., $Initial=$Name.substr(0,1). (It may also be possible to use a rule in the prototype – I didn’t test that.)

  3. In the attribute browser, specify this new attribute ($Initial) at the top instead of the column attribute ($Name).

More elaborate groupings (“A–D”, “E–H”, etc.) are possible with more sophisticated actions.

(Paul Walters) #23

Very clever.

This does work in $Rule as you suspect, and you can adjust $Rule with a Stamp or Quickstamp on the fly, if you wish.

(Brian Crane) #24

This is a smart idea and works great. Thanks so much!

(Pat Maddox) #25

Wow… all this time I never knew about adding columns. That makes AB insanely friggin useful.

I’m looking for a new place to rent right now, and TB is helping me sort through this stuff. There aren’t a whole lot of places that match my constraints, so it may be a project where I need to collect and evaluate information for a while…

(Don Voltz) #26

Could you explain a little more about what you are doing here. I am not completely following this and have been trying to figure out how to keep my ideas and annotations that related to other notes or references. I think this is what you are here and would be interested in hearing more about how you are using the $Lieu.