Incipit.LogosLink.AgencyEngine 2.0.0.2

Introduction

Thank you for downloading this LogosLink package.

LogosLink is a set of tools for discourse analysis, as described in www.iatml.org. You can use LogosLink as an interactive desktop app or by adding the relevant packages to your project.

This is the Incipit.LogosLink.AgencyModel package, which contains types to manage question sets and agency models in terms of their questions, responses, and associated elements.

How to Get Started

Once you have added this package to your project, you can create question sets and agency models, load and save them from disk, and run multiple analytics on them.

Use the QuestionSet and QuestionSetPersister to create, load and save question sets.

Use the AgencyModel and AgencyModelPersister classes to create, load and save agency models. Use the different classes under the Incipit.LogosLink.AgencyModelEngine.Analytics namespace to run analytics on an agency model.

Additional Documentation

Please see the LogosLink Programmer's Guide for complete documentation.

Samples

You can create a new agency model like this:

var aym = new AgencyModel("Test", "YourUserName");

Then, you can add, edit and delete agency model elements like this:

//add a speaker.
var sp = aym.AddNewSpeaker("Alice");

//add a subject-speaker scoped question in a group in the embedded question set.
var qg1 = aym.EmbeddedQuestionSet.AddNewQuestionGroup("M", "Main Question Group");
var txq1 = qg1.AddNewTextQuestion("What is the most central idea according to each speaker?");
txq1.HasSubjectSpeakerScope = true;

//add a response to the question for speaker Alice.
var re1 = aym.AddNewResponse(txq1);
var rep1 = (TextResponsePart)re1.GetResponsePartForScopeSet(sp, null, null, null);
rep1.ResponseText = "China-Japan trade relationships.";

//delete the response.
re1.Delete();

You can load and save agency models like this:

//load an agency model from a file.
var aymp = new AgencyModelPersister("YourUserName");
var aym = aymp.LoadAgencyModel("C:\\Datasets\\My AgencyModel.lly").AgencyModel;

//save it back to disk.
aymp.SaveAgencyModel(aym, null, "C:\\Datasets\\My AgencyModel.lly");

You can run some analytics on an agency model like this:

//create and run an agency structure analyser.
var ana = new AgencyEngine.Analytics.PositionAdherence.PositionAdherenceAnalyser(aym1);
ana.Run();

//dump relative adherence of each position to the console.
foreach (var kvp in ana.PositionAdherenceResults)
{
	Console.WriteLine($"Position: {kvp.Key}\tAdherence: {kvp.Value.RelativeOverall}");
}

Feedback

We love feedback!

Please write to cesar.gonzalez-perez@incipit.csic.es with your comments and questions. You can also send anonymous feedback on the web at www.iatml.org/en/logoslink/feedback.

Thank you!