Explanation of New Feature: Labels

Page 1 of 2 (32 items) 1 2 Next >
This post has 31 Replies | 8 Followers

Posts 620
Jonathan | Forum Activity | Posted: Wed, Oct 29 2014 5:16 AM

Could someone explain to me, in detail, how the new label feature functions?

Here are a couple questions I am struggling to solve:

  • How do the attributes function? What is going on "under-the-hood?"
  • What do the various attributes mean (e.g. Boolean & Word Sense)? I know what "word sense" and "Boolean" mean in other contexts, but I guess I don't understand how they function with this feature.

I believe this will be a very useful feature for me. However, I worry that if I start labelling things with a flawed understanding of the feature I might be wasting my time.

Syntax Searching Group | Michigan Logos Users | L5 FAQ | OSX 10.10 | 2.4 GHz i5 | 8 GB Ram

Posts 2843
David Taylor Jr | Forum Activity | Replied: Wed, Oct 29 2014 6:20 AM

Same question, I have wanted a feature like this but I don't exactly understand how it works.

Teacher, Ministry Leader, Student, Author, Husband

How to upload logs

Visit My Site: Reformed Truths

Posts 790
LogosEmployee
Eli Evans (Faithlife) | Forum Activity | Replied: Wed, Oct 29 2014 3:31 PM

What's happening under the hood is pretty simple: You're adding a note to a selection, and that note contains a label, which you can search on.

So, what's a label? Think of a label like a little fill-in form that you can attach to any piece of text in the library. Like, say, a luggage tag. When you put a luggage tag on a parcel, you're asserting that a) that parcel now is identified as a piece of luggage, and then b) you fill out the "Name," and "Address" lines so that they know exactly whose luggage it is. Or put another way: There's a "Name" attribute and an "Address" attribute.

Labels work the same way: You grab a selection of text and affix a label. That label consists of a NAME that answers the question What is it? and optionally, supplies a set of ATTRIBUTES that answer the question What characteristics would you use to describe or identify it? What you choose as name and attributes for your label is totally up to you, the Ontologist.

An example. Let's say you heard somewhere that each law in Deuteronomy is just a more detailed expression of one of the ten commandments. For example, the command about building parapets on the roof of your house so nobody will fall off and die (Deut 22:8) is essentially a very specific way to apply the general principle "You shall not kill."

We could tag this lots of ways. You could have a label called "Laws That More Specifically Express The Concept of Not Killing" but that's cumbersome. You probably want to choose a minimal name, probably a simple noun or noun phrase, to answer the question What is it? in a general sense. I'm going to (completely arbitrarily) choose "Statute" as the name for this label. Then you want to think about the characteristics you want to describe each instance.

It'll probably make sense if we think about the problem backwards: What do we want to search for? We want to find all the statutes, and we want to be able to find the ones that are (say) expressive of the prohibition against killing. So maybe something like:

Find all the laws I've tagged: {Label Statute}

Find all the laws related to the fifth command: {Label Statute WHERE Decalogue = 5}

(I'm using a Catholic enumeration of the Ten Commandments, but you don't have to.)

You might also want to find the laws that are "apodictic" (generally applicable law) versus "casuistic" (situational or case law) versus "cultic" (specifics of worship). So, find just the case laws: {Label Statute WHERE Type = "casuistic"}

You can string multiple attributes together to narrow things down even further to (say) find all the case laws related to the fifth commandment: {Label Statute WHERE Decalogue = 5 AND Type = "casuistic"}

Let's say our Deut 22:8 example about parapets is one of the verses we'd like to find with this last query. In order for that to work, we'd need to put the following label on that verse:

Statute
Decalogue: 5
Type: casuistic

How do the attributes work? Those last two things, "Decalogue" and "Type" are attributes. Each attribute has a name and a value, and (as you discovered) the value can be of a specific type (Word Sense or Boolean [true/false]). In this example, the "Decalogue" is always going to be a number, so when we set up the highlighting style to apply this label (the easiest way to do it), then we're going to specify that attribute's value is always a number so that the entry helper will only show us numbers. Similarly, the "Type" we know is going to have three legal values, so we're going to say that the type of value for the "Type" attribute is a "List" and we're going to give the legal values separated by a semicolon.

If you had, say, an attribute that you knew was always going to be a biblical person, you'd choose "Biblical Person" as the attribute type. If you don't know or don't care, then "Any Value Type" is what you'd choose.

Anyway, the following video shows me setting up a Highlighting palette from scratch to show the "Statute" example above. I set it to "prompt me for attributes" so that whenever I apply that highlighter style it pops up a little form for me to fill in. The attribute list in the style is what sets up the blank form. Then I apply the label to a verse, fill in the form that pops up. Finally, I do a little searching to demonstrate that you can indeed find that verse by the queries above.

http://screencast.com/t/QzhHb8jyW 

Since this goes into note files, I could make a Faithlife group and share this document. Anyone in that group could grab a copy, or they could even collaborate on it.

This is very definitely a power-user feature. But it opens up a HUGE range of possibilities. 

Hope that helps! I could work out other examples, too.

Posts 10331
Forum MVP
Jack Caviness | Forum Activity | Replied: Wed, Oct 29 2014 5:00 PM

Eli Evans:

Thanks for the screencast, but on Mac OS 10.10, it was a silent movie—without the Keystone Cops Big Smile

Posts 176
Kendall Sholtess | Forum Activity | Replied: Wed, Oct 29 2014 5:02 PM

Faithlife webteam:

Can you guys make your What's New posts to stick to the top of the forum? It's hard to weed through the many other posts to find them.

Posts 1955
Forum MVP
Randy W. Sims | Forum Activity | Replied: Wed, Oct 29 2014 5:08 PM

You can use the main What's New post that is pinned to the top as a directory to the others.

Forum ThemeEnhanced Forum Search

Custom PC: Core i9; 32GB RAM; GeForce GTX 970; Win 10 Pro
Google Pixel XL | Apple iPad pro 9.7

Posts 790
LogosEmployee
Eli Evans (Faithlife) | Forum Activity | Replied: Wed, Oct 29 2014 5:21 PM

Jack Caviness:

Thanks for the screencast, but on Mac OS 10.10, it was a silent movie—without the Keystone Cops Big Smile

I neglected to mention: No sound

Posts 2843
David Taylor Jr | Forum Activity | Replied: Wed, Oct 29 2014 5:48 PM

Yes Eli that is exactly the functionality I had hoped for it was just a little overwhelming at first.  Would love to be able to grab a copy of the pallate/note file

Teacher, Ministry Leader, Student, Author, Husband

How to upload logs

Visit My Site: Reformed Truths

Posts 790
LogosEmployee
Eli Evans (Faithlife) | Forum Activity | Replied: Wed, Oct 29 2014 6:39 PM

Sure. I shared the note file with All Users. You can grab a copy here: https://documents.logos.com/documents/f06694d810ca4945a6a1964f29fd1fb0

The palette should come along. It's just the one style.

Posts 790
LogosEmployee
Eli Evans (Faithlife) | Forum Activity | Replied: Wed, Oct 29 2014 6:55 PM

Bradley also wrote an overview of the feature here: https://community.logos.com/forums/t/92700.aspx

Posts 391
Geo Philips | Forum Activity | Replied: Wed, Oct 29 2014 6:59 PM

I wish someone made a text label for each book of the Bible. Big Smile

Posts 1118
Mike Tourangeau | Forum Activity | Replied: Thu, Oct 30 2014 9:26 AM

Ok, I am getting this feature a bit but I am missing some things. I have created a new Palette titled "Theology" and I would like to tag a section of text as "Theology" and give it the attribute (say) "Justification"

I can search {Label theology} and see my tag, but I can't search by attribute {Label theology justification}

So is it that you create a new palette for each label? If so what are the purposes of attributes?

I feel like this is something I have wanted for a while and I am on the verge of understanding it :) Thanks 

Posts 12813
Forum MVP
Mark Barnes | Forum Activity | Replied: Thu, Oct 30 2014 9:30 AM

Mike Tourangeau:
I can't search by attribute {Label theology justification}

It's {Label theology WHERE attribute=justification}

Replace "attribute" with the name of your attribute.

Posts 1118
Mike Tourangeau | Forum Activity | Replied: Thu, Oct 30 2014 9:44 AM

Mark Barnes:
Replace "attribute" with the name of your attribute.

Thanks Mark! Now I just have to develop a strategy.....I trust we will be seeing some totally cool and innovative videos from you on L6? :)

Posts 1118
Mike Tourangeau | Forum Activity | Replied: Thu, Oct 30 2014 10:45 AM

Another couple of questions:

1. Right now I can bring bring up the  Labeling box by assigning a quick key to that Palette. Is there another way to quickly add a Label? Adding note to that file doesn't attach a Label.

2. What is the benefit of naming the "Attribute Name" and the "Value?" Can search by each? - and if so how. Right now I labeled the attribute name the same as the value to get it to show up in searches.

Thanks!

Posts 2843
David Taylor Jr | Forum Activity | Replied: Thu, Oct 30 2014 11:35 AM

Mike Tourangeau:

Mark Barnes:
Replace "attribute" with the name of your attribute.

Thanks Mark! Now I just have to develop a strategy.....I trust we will be seeing some totally cool and innovative videos from you on L6? :)

+1 Yes

Teacher, Ministry Leader, Student, Author, Husband

How to upload logs

Visit My Site: Reformed Truths

Posts 12813
Forum MVP
Mark Barnes | Forum Activity | Replied: Thu, Oct 30 2014 11:49 AM

Mike Tourangeau:
What is the benefit of naming the "Attribute Name" and the "Value?" Can search by each? - and if so how. Right now I labeled the attribute name the same as the value to get it to show up in searches.

You can have multiple attributes for each label. Each attribute needs to have a different name.

So, for theology, you might have attributes called "doctrine" and "soundness" (a silly example, I know!). You could then apply a label to your favourite systematic theology which had "doctrine" set to "pneumatology" and soundness set to "right on". Your least favourite theology might have a chapter where doctrine is set to "Marcionism" and soundness set to "dodgy".

You could then search for things like:

  • {Label theology WHERE doctrine=pneumatology}
  • {Label theology WHERE soundness=dodgy}

Does that make sense?

This post will help, too: https://community.logos.com/forums/t/92700.aspx 

Posts 7827
LogosEmployee
Bradley Grainger (Faithlife) | Forum Activity | Replied: Thu, Oct 30 2014 11:59 AM

Mark Barnes:
dodgy

For the non-British among us: http://www.merriam-webster.com/dictionary/dodgy 

Posts 5602
Todd Phillips | Forum Activity | Replied: Thu, Oct 30 2014 12:05 PM

Bradley Grainger (Faithlife):

Mark Barnes:
dodgy

For the non-British among us: http://www.merriam-webster.com/dictionary/dodgy 

I didn't know "dodgy" was considered a Britishism.  Seems familiar enough to me.  Maybe British television has impacted me more than I thought.

Wiki Links: Enabling Logging / Detailed Search Help - MacBook Pro (2014), ThinkPad E570

Posts 790
LogosEmployee
Eli Evans (Faithlife) | Forum Activity | Replied: Thu, Oct 30 2014 12:38 PM

Mike Tourangeau:
2. What is the benefit of naming the "Attribute Name" and the "Value?" Can search by each? - and if so how. Right now I labeled the attribute name the same as the value to get it to show up in searches.
Mike Tourangeau:
2. What is the benefit of naming the "Attribute Name" and the "Value?" Can search by each? - and if so how. Right now I labeled the attribute name the same as the value to get it to show up in searches.
Mike Tourangeau:
1. Right now I can bring bring up the  Labeling box by assigning a quick key to that Palette. Is there another way to quickly add a Label? Adding note to that file doesn't attach a Label.

If you want to add a label to a note manually, you can use the "Add Label" command in the drop-down menu that appears in the upper-right corner of a note on hover:

Page 1 of 2 (32 items) 1 2 Next > | RSS