Ego-Netzwerke: Namensgeneratoren, Namensinterpretatoren, Dyadenzensus und Soziogramme

Neu in v2.12.0

ego_network erhebt ein persönliches (egozentriertes) Netzwerk, einen Standardgegenstand der sozialen Netzwerkanalyse. Die befragte Person, das Ego, nennt Personen (Alteri), beantwortet Fragen zu jeder von ihnen, gibt an, welche von ihnen einander kennen, und platziert sie auf einer Karte. Das Schema funktioniert auf einer Umfrageseite, wie die meisten Studien zu persönlichen Netzwerken es einsetzen, und auf Annotationsitems, wo eine codierende Person das Netzwerk erfasst, das ein Dokument beschreibt.

Ein Schema enthält eine geordnete Liste von Stufen. Jede Stufe arbeitet mit derselben Menge von Alteri, sodass eine im ersten Namensgenerator genannte Person in jeder späteren Stufe erscheint.

Standardmäßig werden die Stufen einzeln angezeigt, jede mit eigenen Schaltflächen Back und Next und einer Reihe von Schrittschaltflächen. stage_layout: stacked zeigt alle zugleich auf der Seite.

Konfiguration

Führen Sie auf einer Umfrageseite die Seite unter phases auf und legen Sie das Schema in ihre Datei:

phases:
  order: [your_network, annotation]
  your_network:
    type: prestudy
    file: surveys/your-network.json

Die Seitendatei enthält das Schema, hier in YAML gezeigt. Dieselben Schlüssel funktionieren in annotation_schemes:

- annotation_type: ego_network
  name: personal_network
  description: People you talk to
  label_requirement:
    required: true
  stages:
    - type: name_generator
      id: discuss
      title: Important matters
      prompt: >-
        Looking back over the last six months, who are the people you talked
        to about matters that are important to you?
      min_alters: 1
      max_alters: 8
      sets: {discuss: true}
    - type: name_generator
      id: help
      title: Practical help
      prompt: Who would you ask for help if you were ill for a couple of weeks?
      sets: {help: true}
    - type: name_interpreter
      id: about
      title: About each person
      required: true
      questions:
        - name: closeness
          type: radio
          description: How close do you feel to {name}?
          labels:
            - {name: very, text: Very close}
            - {name: somewhat, text: Somewhat close}
            - {name: not, text: Not close}
        - name: years_known
          type: number
          description: About how many years have you known {name}?
          min: 0
          max: 100
          required: false
    - type: dyad_census
      id: know
      prompt: Do {a} and {b} know each other?
    - type: sociogram
      id: map
      rings: 3

Jede Stufe nimmt type, id (ein Buchstabe, gefolgt von Buchstaben, Ziffern, _ oder -, standardmäßig <type>_<n>), title, prompt und instructions.

Namensgeneratoren

Wird ein Name eingetippt, der schon auf der Liste steht, wird er mit einer Meldung abgewiesen, damit eine Person nicht doppelt erfasst wird. Ein späterer Namensgenerator listet die früher genannten Personen unter "Named earlier" auf, und die befragte Person fügt mit einem Klick alle hinzu, die auch dorthin gehören. Der Alter behält eine ID und verzeichnet jeden Generator, der ihn genannt hat. Wird eine Person aus dem einzigen Generator entfernt, der sie genannt hat, verschwindet sie samt ihren Antworten und Beziehungen aus dem Netzwerk.

Namensinterpretatoren

Eine Stufe name_interpreter nimmt questions (erforderlich) und required, den Standard für ihre Fragen. Jede Frage hat name (eindeutig im gesamten Schema), type (radio, multiselect, number oder text), description ({name} wird durch den Namen der Person ersetzt), labels für radio und multiselect (Strings oder {name, text}, wobei name das Gespeicherte ist), required sowie min, max und step für Zahlen. Die Seite zeigt eine Karte pro Person mit allen Fragen darauf.

Dyadenzensus

Der Zensus zeigt jeweils ein Paar und geht nach jeder Antwort zum nächsten unbeantworteten Paar. "All pairs" listet alle Paare mit ihrer Antwort auf, und ein Klick auf eines führt dorthin zurück.

Soziogramm

Positionen werden als Bruchteile von Breite und Höhe der Zeichenfläche gespeichert. Eine im Soziogramm gezeichnete Linie und eine Zensusantwort für dieselbe Relation sind derselbe Datensatz, sodass das Zeichnen einer Linie zwischen zwei Personen ihre Zensusantwort auf Ja setzt und das Entfernen auf Nein.

Jedes Bedienelement ist eine Schaltfläche oder ein Textfeld, das mit Tab erreichbar ist. Im Soziogramm wechselt Tab zwischen Personen, Enter wählt eine aus und öffnet eine Liste aller anderen, um Beziehungen hinzuzufügen oder zu entfernen, die Pfeiltasten bewegen die fokussierte Person (mit Shift weiter), und Escape schließt die Liste.

Datenformat

Die Antwort wird als ein einziger JSON-String gespeichert:

{
  "alters": [{"id": "a1", "name": "Ann", "named_in": ["discuss", "help"]},
             {"id": "a2", "name": "Bob", "named_in": ["discuss"]}],
  "attributes": {"a1": {"discuss": true, "help": true, "closeness": "very"}},
  "ties": [["a1", "a2"]],
  "positions": {"a1": [0.42, 0.31], "a2": [0.7, 0.55]},
  "census": {"a1|a2": true},
  "tie_attributes": {}
}

Alter-IDs sind a1, a2 und so weiter, in der Reihenfolge, in der die Personen genannt wurden, und eine gelöschte ID wird nicht wiederverwendet. Eine Beziehung ist [a, b] oder [a, b, relation], wenn die Stufe eine Relation nennt.

Export

python -m potato.export --config config.yaml --format ego_network --output out/

Das Ego ist in diesen Dateien kein Knoten. Dichte, Komponenten und Grad werden über Beziehungen zwischen Alteri berechnet, und zwei Personen, die über zwei Relationen verbunden sind, zählen als ein verbundenes Paar.

Namen der Alteri

Die Namen, die Befragte eintippen, identifizieren Personen, die der Teilnahme an der Studie nicht zugestimmt haben. Der Export ego_network lässt sie daher weg und schreibt nur die pseudonymen IDs. --option export_names=true nimmt sie mit auf.

Die Namen stehen weiterhin in der Rohausgabe (annotation_output/) und in den allgemeinen Exporten (csv, jsonl), die das gespeicherte JSON unverändert schreiben. Fragen Sie Befragte nach Vornamen oder Spitznamen und behandeln Sie diese Dateien als identifizierbare Daten.

Vollständigkeit

Mit label_requirement: {required: true} lässt die Seite kein Weitergehen zu, solange ein Namensgenerator weniger als min_alters Personen hat, eine erforderliche Frage eines Namensinterpretators für jemanden unbeantwortet ist oder ein Dyadenzensus unbeantwortete Paare hat, und sie gibt an, was fehlt. Innerhalb des Widgets bleibt Next auf einem Namensgenerator stehen, bis dieser min_alters Personen hat, unabhängig davon, ob das Schema erforderlich ist.

Ein Network-Canvas-Protokoll importieren

potato import -f network_canvas -i my-study.netcanvas -o my-study/ liest ein Network Canvas-Protokoll, entweder die in Architect gespeicherte .netcanvas-Datei oder eine bloße protocol.json. Ego-Formulare werden zu Seiten mit gewöhnlichen Fragen, und die Netzwerkstufen für jeden Knotentyp werden zu einer ego_network-Frage:

Optionswerte werden als gespeicherte Antworten beibehalten, sodass Exporte dieselben Codes wie das Protokoll tragen. Skip-Logik auf Ego-Variablen wird zu show_when der Seite, und ein Sprung zu einer Stufe FinishSession wird zu exit_when auf der vorherigen Seite, sodass eine teilnehmende Person, die die Einwilligung ablehnt, die Studie dort verlässt. Protokolle mit Übersetzungen werden auf Englisch importiert, sofern Sie nicht --survey-language übergeben.

Manches ändert sich. Alle Netzwerkstufen für einen Knotentyp teilen sich eine Seite, die dort steht, wo die erste von ihnen war, sodass eine Netzwerkstufe, die nach anderen Seiten kam, vor diese rückt, und der Import warnt bei jeder. Das Ziehen von Personen in Bins wird zu einer Auswahl pro Person, mit denselben gespeicherten Werten. Skip-Logik, die Knoten- oder Kantendaten prüft, AlterEdgeForm, Narrative, Geospatial und die Stammbaumstufen, Datumsauswahlen, Medien-Items und Notizen für Interviewende werden in IMPORT_REPORT.md aufgeführt und nicht importiert.

Beispiel

examples/advanced/ego-network/ führt das Schema zweimal aus: als Umfrageseite vor der Aufgabe, für das eigene Netzwerk der teilnehmenden Person, und als Annotationsaufgabe, in der Codierende das Netzwerk erfassen, das jeder Interviewausschnitt beschreibt.

python potato/flask_server.py start examples/advanced/ego-network/config.yaml -p 8000

Setzen Sie "Yes" und "No" in Labellisten in Anführungszeichen, weil YAML sie ohne Anführungszeichen als Booleans liest, und schreiben Sie stage_layout: stacked, nicht layout: stacked, da layout die Zuordnung für die Rasterplatzierung ist, die jedes Schema akzeptiert.

Weiterführende Informationen

• Umfrageimport - Network Canvas und sechs weitere Fragebogenformate
• Mehrphasige Workflows - Umfrageseiten vor und nach der Aufgabe
• Kulturelle Domänenanalyse - Freie Listen und Triadentests für dieselben Befragten

Implementierungsdetails finden Sie in der Quelldokumentation.