כותב גרף פסק דין וביצוע לפי מודל הטיעון של טולמין. זו משפחת הליבה שבאמצעותה GEUL מתארת את כלליה שלה ב-GEUL ומתקנת את עצמה.

קבוצהCodec
הצהרהCASE-DECLARE (מקרה), PREDICATE-DECLARE (פרדיקט), SPEC-DECLARE (קריטריון שיפוט), RULE-DECLARE (טענה), COUNTER-DECLARE (ראיית נגד), EXCEPT-DECLARE (חריג) — NODE
קשרATTACKS (תקיפה), SUPERSEDES (הדרה) — LINK, SUPERSEDE-CHAIN (שרשרת עדיפויות, הפריסה טרם נקבעה)
ביצועRUN, DO, DO-ONCE, UNDO, CHECKING — LINK, ENTRY, TRIGGER — NODE
תוצאהVERDICT (תוצאת פסק דין: Pass·Review·Fail), EVIDENCE (ראיה לפסק הדין) — הפריסה טרם נקבעה
  • צמתי טקסט המקור, החלוקה למקטעים וצמתי העזר והקשרים הם הקודים הישירים 0x120L~0x134L של משפחת פורמט TOULMIN (SOURCE ומקטעים, TOULMIN).
  • תוצאת פסק הדין נשמרת במסמך שונה מהמסמך שנפסק. מסמך התוצאה מייבא את מסמך היעד ומצביע עליו. לכן פסק הדין אינו משנה את hash התוכן של מסמך היעד.

ה-Edge של משפחת TOULMIN (קודים ישירים 0x100L~0x11BL, ורשומות העזר במשפחת פורמט TOULMIN 0x120L~0x134L) כותבים גרף פסק דין וביצוע לפי מודל הטיעון של טולמין. הצהרות של טענה, ראיית נגד וחריג, יחסי תקיפה והדרה, חיבורי ביצוע ותוצאות פסק דין הם כולם Edge. מסמך TANGEUL אחד (שפת הכללים של מנוע toulmin) הופך למסמך GEUL אחד. סיומת הקובץ היא .geul, כמו בשאר המסמכים.

מה שהמסמך הזה לא קובע נקבע לפי הכללים המשותפים של Edge ו-רשומה ו-TAG WORD.

מטא-קוגניציה ותיקון עצמי

TOULMIN הוא Codec של GEUL כדי ש-GEUL תוכל להכיר את עצמה (מטא-קוגניציה). רק אם גם כללי פסק הדין והביצוע מתוארים ב-GEUL, יכול TOULMIN לקחת את הכללים האלה כיעד ולתקן אותם בעצמו. לכן TOULMIN אינו פרופיל יישומי אלא ליבת ההפעלה של GEUL, והוא ממוקם במרחב הקודים הישירים של Edge (0x100L~0x11BL).

  • תיאור עצמי מאפשר שיפור עצמי, אך נושא סיכון של שגיאה מעגלית. אם כלל פוסק בעצמו על תיקון של עצמו, גם תיקון שמרפה את קריטריון השיפוט יכול לעבור (שיעור המעבר עולה והדיוק האמיתי יורד).
  • מקבלים את המעגליות כסיכון, וקוטעים אותה באמצעות מבנה.
    • ליבה קבועה: משמעות פסק הדין (Pass·Review·Fail, תקיפה·הדרה·עדיפות, ההערכה בשלושה ערכים ו-U → Review שבפסק דין על קלט לא ידוע להלן) קבועה במפרט הזה. אי אפשר לשנות אותה באמצעות מסמך TOULMIN. זהו אותו מקום של הכללים המשובצים במפענח (שכבה 0 בכתובת פרסום ורשימת גרסאות).
    • הפרדת מהדורות: תיקון של מסמך כללים v(n) נפסק לפי כללי v(n−1) ובדיקה חיצונית. כלל אינו פוסק על עצמו. תוצאת פסק הדין נשמרת במסמך שונה מהיעד (hash התוכן של היעד אינו משתנה).
    • היסטוריה בלתי משתנה: תיקונים נערמים כגרסאות חדשות (PARENT, hash תוכן, חתימה). הגרסאות הישנות נשארות, ולכן אפשר למצוא שגיאה מעגלית בדיעבד ולהחזיר אחורה. רשת הביטחון של תיקון עצמי היא מודל המהדורות של GEUL (מסמך).
    • אמת מידה חיצונית: מחזיקים בנפרד קבוצת מקרי בדיקה שנתיב התיקון אינו יכול לגעת בה. קבלת תיקון מאומתת לפי תוצאת הקבוצה הזו.
  • בדיקת הפרכה: מטמיעים בכוונה כלל שגוי אחד. אם המערכת מתקנת אותו וציון אמת המידה החיצונית עולה, השיפור העצמי פועל. אם רק שיעור המעבר עולה וציון אמת המידה החיצונית יורד, זו שגיאה מעגלית.

קוד

רשומת TOULMIN משתמשת באחת משלוש פריסות. הפריסה נקבעת לפי ה-Codec.

פריסהשימושדף
NODEצמתי גרף כגון מקרה, כלל, הגדרה, נקודת כניסהNODE
LINKקשרים בין צמתים (תקיפה, הדרה, ביצוע, הגדרה)LINK
EXPRביטוי תנאי (פרדיקט)EXPR

רשומות טקסט המקור והחלוקה למקטעים (SOURCE, TEXT, SECTION, CASE-BEGIN·CASE-END, PROSE) נקבעות ב-SOURCE ומקטעים.

קוד ישיר

CodecשםפריסהTANGEULמשמעות
0x100LCASE-DECLARENODEin case ofהצהרת מקרה. גרף פסק דין שנושא צמתים וקשרים
0x101LPREDICATE-DECLAREEXPRביטוי תנאי ב-Rulesהצהרת פרדיקט. ביטוי פסק דין
0x102LSPEC-DECLARENODEפריט Definitionsהצהרת קריטריון שיפוט (Backing). ביט ה-role קובע את סוג ההגדרה
0x103LRULE-DECLARENODEgeneral rule, שם הכלל ב-Rulesהצהרת טענה (Warrant). אפשר לתקוף אותה
0x104LCOUNTER-DECLARENODEcounter ruleהצהרת ראיית נגד. תוקפת עם מסקנה משלה. ה-Level המשתמע הוא Fail
0x105LEXCEPT-DECLARENODEexcept ruleהצהרת חריג. תוקף ללא מסקנה משלו. ה-Level המשתמע הוא Review
0x108LATTACKSLINKdon't X when Yיחס תקיפה. פסק התוקף מקטין בהדרגה את פסק היעד בעוצמת התקיפה (0~1, ברירת מחדל 1)
0x109LSUPERSEDESLINKX supersedes Yיחס הדרה. אם התוקף Active, הוא מוציא את היעד מהצבירה באופן מכריע. שרשרת (A > B > C) נכתבת בקשר אחד לכל זוג
0x10ALSUPERSEDE-CHAIN—שרשרת עדיפויות A > B > C. קיצור של SUPERSEDES לפי זוגות. הוקצה רק הקוד, ועדיין אין פריסה
0x110LRUNLINKrun c when nהרכבת ביצוע. אם הצומת Active, מריצים את המקרה התחתון (DAG)
0x111LDOLINKdo fn when nפעולה שמבוצעת כשהצומת Active
0x112LDO-ONCELINKdo fn once when nפעולה שמבוצעת פעם אחת בלבד גם בניסיון חוזר
0x113LUNDOLINKundo fn when nפעולת פיצוי של DO‏ (saga). אם שלב מאוחר יותר נכשל, מבוצעת בסדר הפוך
0x114LCHECKINGLINKchecking cחיבור שרק פוסק, ללא תופעות לוואי
0x115LENTRYNODEprovides xנקודת כניסה חיצונית. מריצה או פוסקת מקרה
0x116LTRIGGERNODEon, every, untilנקודת כניסה של אירוע או מחזור, ללא קריאה חיצונית
0x118LVERDICT—תוצאת פסק הדין של צומת או רשומה. תוצאה (Pass, Review, Fail), ערך פסק דין, Activated, Excluded, Level. הוקצה רק הקוד, ועדיין אין פריסה
0x119LEVIDENCE—ראיה לפסק הדין. מיקום, ערך צפוי, ערך בפועל (Fact). הוקצה רק הקוד, ועדיין אין פריסה
0x11CL~0x11FLReserved
  • קודים ישירים שאינם בטבלה (0x106L·0x107L, 0x10BL~0x10FL, 0x117L, 0x11AL·0x11BL) הם Reserved.
  • הקבוצות הן 0x100L~0x107L הצהרה, 0x108L~0x10FL קשר, 0x110L~0x117L ביצוע, 0x118L~0x11FL תוצאה (0x11CL~0x11FL הם Reserved).
  • פסק הדין של המסמך כולו מוטל על VERDICT של Meta‏ (VERDICT, 0x1E9L), ופסק הדין של צומת או רשומה מוטל על VERDICT של TOULMIN‏ (Edge ‏0x118L). השניים הם Codec נפרדים עם Kind שונה.

פורמט TOULMIN

טקסט המקור, החלוקה למקטעים והצמתים והקשרים העזר נמצאים בקודים הישירים 0x120L~0x134L של משפחת Edge פורמט TOULMIN. אין שדות Issuer ומספר Codec, וה-Payload בא ישר אחרי ה-TAG.

TAG WORD          0001 0010 0000 LLLL      Edge, Codec 0x120L (SOURCE). קודים אחרים באותו מקום
[TAG הרחבת Length]
Edge Id           רשומת LOCAL Reference
רכיבים            הפריסה שהפורמט קובע
Codecשםפריסהמשמעות
0x120LSOURCEID, WORD רוחב SPAN, UTF8 Valueטקסט המקור של הכתיבה
0x121LTEXTID, UTF8 Valueשם או מחרוזת
0x122LSECTIONID, קוד קטע ב-WORD אחדתחילת קטע
0x123LCASE-BEGINID, REF (מקרה)תחילת טווח המקרה
0x124LCASE-ENDID, REF (מקרה)סוף טווח המקרה
0x125LPROSEID, SPANפסקת תיאור
0x126LNAMESPACENODEthis document is
0x127LFUNCNODEהפניה לפונקציה
0x128LFIELDNODEis required
0x129LALIASNODEsee … from
0x12ALGROUPNODEקבוצת ביצוע מסודרת
0x12BLREQUIRESLINKמקרה → שדה
0x12CLMEANSLINKפריט הגדרה → ערך או טיפוס
0x12DLHASLINKפריט הגדרה → שדה
0x12ELRUNSLINKנקודת כניסה → מקרה, ביצוע
0x12FLEVALUATESLINKנקודת כניסה → מקרה, פסק דין
0x130LTRIGGERSLINKטריגר → מקרה
0x131LUNTILLINKטריגר → מקרה (every … until)
0x132LSAME-ASLINKצומת → מזהה גלובלי
0x133LIMPORTED-FROMLINKכינוי → נתיב (TEXT)
0x134LLABELLINKצומת → TEXT, סימון שם

מסמך

קובץ .geul אחד הוא DOC אחד. אין להניח בתים אחרים מחוץ ל-DOC.

DOC-1WORD/2WORD/4WORD     אורך כולל
  SPEC-VERSION            0x0001 (v1, מספר שלם ללא Value משובץ)
  PROFILE                 UTF8 Value "tangeul-<major>.<minor>". כעת "tangeul-1.0"
  [DEFAULT-LANGUAGE]      LANGUAGE-BCP47-CODE Value. אזור השפה של הכתיבה ("en", "ko")
BODY
  SOURCE                  טקסט המקור של הכתיבה. הרשומה הראשונה ב-BODY
  רשומות משפט …            לפי סדר ההצהרה במסמך
END
  • HEAD: ‏SPEC-VERSION, ‏PROFILE, ו-DEFAULT-LANGUAGE אופציונלי.
  • המפענח דוחה אם SPEC-VERSION שונה או שה-major של PROFILE שונה. אם רק ה-minor שונה, הוא קורא.
  • הרשומה הראשונה ב-BODY היא SOURCE. כל SPAN הוא טווח בתוך טקסט המקור הזה.
  • סדר רשומות המשפט שווה לסדר ההצהרה במסמך. סדר הביצוע (הפעלת do·run, ופיצוי בסדר הפוך של undo) נשען על הסדר הזה. במסמך TOULMIN לסדר ה-Edge יש משמעות (יוצא דופן בכלל הסדר שבפריסת Edge).
  • כל הרשומות ב-BODY הן Edge. אין רשומות Value עצמאיות. ערכים משובצים ב-Payload של ה-Edge.
  • זהות המקרה והייבוא נכתבים ב-DOC-ID וב-IMPORT-DOC של Meta (Subject ו-See של TANGEUL).

שדות משותפים

שדהרוחבהסבר
IDרשומת LOCAL Referenceה-Edge Id של הרשומה. האיבר הראשון ב-Payload של כל רשומה
REFרשומת LOCAL ReferenceEdge Id שמצביע על רשומה אחרת במסמך הזה. 0 פירושו אין
SPANהרוחב שקבע SOURCE × 2טווח בטקסט המקור של הכתיבה. בייט התחלה, מספר בייטים
  • ID ו-REF הם רשומות LOCAL Reference משובצות (0000 0000 0101 LLLL + ID ברוחב הקצר ביותר). הרוחב נקבע לפי Length של הרשומה ואינו מוצהר ברמת המסמך.
  • REF ‏0 (‏LOCAL ‏0) פירושו «אין». זהו כלל של Codec שמשתמש ב-LOCAL ‏0 כ«אין» (LOCAL).
  • Edge Id מוקצה מ-1 ואינו חוזר בתוך המסמך. 0 הוא «אין» של REF ולכן אינו משמש כ-Edge Id.
  • צמתים מקבלים מספר ראשונים לפי סדר ההצהרה במסמך, כי רשומות אחרות מפנות אליהם קדימה. שאר הרשומות (SOURCE, TEXT, LINK, FUNC, רשומות החלוקה למקטעים) מקבלות מהמקודד מספרים אחרי הצמתים.
  • המפענח בודק רק ש-Edge Id אינו 0 ושאין כפילויות. סדר ההקצאה אינו משמש בפירוש.
  • צמתים וקשרים מוצבעים באמצעות Edge Id.
  • Value משובץ הוא רשומת Value כפי שהיא, כולל TAG WORD. אורכו נקבע לפי ה-TAG שלו.

ערכים מספריים

  • ערך פסק דין (−1~1), Qualifier (0~1) ועוצמת תקיפה (0~1) הם SIGNED-DECIMAL Value. אין פורמט נקודה קבועה נפרד.
  • המקודד מוחק אפסים בסוף המקדם. 0.8 הוא C=8, E=−1. המפענח מקבל עד ארבע ספרות אחרי הנקודה.
  • שער ביטחון (למשל at least 75%) נכתב כאופרטור השוואה ב-WORD אחד ו-UNSIGNED-DECIMAL Value של אחוזים (E=0) (LINK F_GATE).
  • עוצמת תקיפה היא שדה F_FORCE של ATTACKS (LINK). מחוץ לטווח, דוחים.

צירי הצהרת צומת

  • הצהרת צומת (RULE·COUNTER·EXCEPT-DECLARE) כוללת תפקיד (טענה, ראיית נגד, חריג), Qualifier‏ (0~1) ו-Level‏ (Unset, Fail, Review). התפקיד נישא ב-role של ה-Codec וכותרת NODE, ה-Qualifier ב-F_QUAL, וה-Level ב-level של הכותרת (NODE).
  • חוזק (Strict, Defeasible, Defeater) הוא ציר נפרד מהתפקיד. מיקום החוזק טרם נקבע.
  • עוצמת תקיפה (Force) היא ערך של קשת ATTACKS ולא של צומת (LINK F_FORCE). זהו ציר שונה מחוזק.

פסק דין על קלט לא ידוע

כשגרף פסק דין מקבל עובדות GEUL כקלט, שלושת המושגים של סמן מקום (לא נכתב, לא ידוע, אין) מוערכים באופן שונה. הערכת אופרטורי ההשוואה של EXPR היא כדלקמן.

קלטis emptyis not emptyequals / is in / השוואת גודל
ערך vשקראמתמוערך לפי v
NO-VALUE (אין)אמתשקרשקר
UNKNOWN-VALUE (לא ידוע)שקראמתלא מוכרע (U)
ABSENT (לא נכתב) / היעדר היגדU (עולם פתוח)UU
  • הלוגיקה היא Kleene החזקה בשלושה ערכים. NOT U = U, ‏שקר AND U = שקר, ‏אמת OR U = אמת. בשאר הצירופים U הוא U.
  • EXISTS any הוא אמת אם אחד האיברים לפחות אמת. אם אין אמת ויש U, התוצאה U, ואם כולם שקר, התוצאה שקר.
  • אם הפרדיקט הוא U, פסק הצומת אינו Pass או Fail אלא Review. מה שלא ידוע מועבר לאדם (או לשלב הבא).
  • כדי לקרוא ABSENT כ-empty ולא כ-U, צד הקלט חייב להצהיר על עולם סגור (הזרקה כקריטריון שיפוט SPEC, למשל: «הקלט של המקרה הזה שלם»). בלי הצהרה זה U.
  • הטבלה הזו והמיפוי U → Review הם משמעות פסק הדין ולכן ליבה קבועה. אי אפשר לשנות אותם באמצעות מסמך TOULMIN.
  • דוגמה: כלל «סופרים רק גבולות שעדיין בתוקף» (P582 is empty): אם P582 = UNKNOWN-VALUE הוא שקר ולכן מוציא את הגבול; אם P582 = NO-VALUE הוא אמת ולכן כולל אותו; ואם P582 חסר הוא U ולכן שולח ל-Review.

תוצאת פסק דין

  • תוצאת פסק הדין (VERDICT, EVIDENCE) נשמרת במסמך שונה ממסמך היעד. מסמך התוצאה מייבא את מסמך היעד באמצעות IMPORT-DOC ומצביע עליו באמצעות EXTERNAL-POINTER-*. לכן פסק הדין אינו משנה את hash התוכן של מסמך היעד.
  • פסק הדין של המסמך כולו הוא VERDICT של Meta, ופסק הדין של צומת או רשומה הוא VERDICT של TOULMIN.
  • גם הכללים לבחירת המהדורה שחלה בתיקון (הוראות מעבר, בחירה בין החוק בעת המעשה לחוק החדש), וכן פרשנויות ופסיקה, משמשים ככללי פסק דין (מסמך).

בעיות פתוחות

  • הפריסה של SUPERSEDE-CHAIN‏ (0x10AL), VERDICT‏ (0x118L) ו-EVIDENCE‏ (0x119L). והאם הדרך הנוכחית, SUPERSEDES אחד לכל זוג, מספיקה לשרשרת.
  • מיקום חוזק הצומת (Strict, Defeasible, Defeater).
  • ל-ATTACKS שכתוב בו עוצמת תקיפה 1 ול-ATTACKS שלא כתוב בו אותו פסק דין זהה אך הבייטים שונים. כדי לדעת אם פסק הדין זהה יש להשוות את הערכים המפורשים ולא את הבייטים.
  • מספר הצמתים, מספר התוויות ואינדקס התווית בתוך EXPR הם 1 WORD, ומספר הילדים הוא 13 ביט. הגבול העליון קבוע.
  • פריסת PROVENANCE (מקור הכלל ותנאיו המקדימים).
  • האם לתת לשם בגרשיים הפוכים תפקיד של LABEL ו-BIND מסוג Edge של היגד במקום TEXT + LABEL‏ (0x134L).
  • טבלת ערכי הקוד של predicate ו-mode ב-Claim, וערכי הקוד של VerbCode ב-FuncRef.
  • האם הצהרת עולם סגור (קריאת ABSENT כ-empty) נעשית בקריטריון שיפוט (SPEC) או ברמת המקרה.
  • מסמך המפרט של Codec עבור Codec של TOULMIN. השדות המותנים של NODE ו-LINK ורוחב ה-SPAN שקובע SOURCE הם פריסות שאי אפשר להצהיר עליהן באמצעות FIELD.

דפים קשורים

NODE

NODE היא פריסה שכותבת צומת בגרף פסק הדין והביצוע של TOULMIN. סוג הצומת נקבע לפי ה-Codec, ו-WORD כותרת אחד קובע את התפקיד, ה-Level, צורת ה-Claim והשדות המותנים.

Codec

CodecשםTANGEULצומת
0x100LCASE-DECLAREin case ofמקרה
0x102LSPEC-DECLAREפריטי Definitions (means, has)קריטריון שיפוט (Backing). ה-role הוא סוג ההגדרה
0x103LRULE-DECLAREgeneral ruleטענה (Warrant)
0x104LCOUNTER-DECLAREcounter ruleראיית נגד (Rebuttal)
0x105LEXCEPT-DECLAREexcept ruleחריג (Defeater)
0x115LENTRYprovides xנקודת כניסה חיצונית
0x116LTRIGGERon, every, untilנקודת כניסה של אירוע או מחזור
0x126LNAMESPACEthis document isמרחב השמות של המסמך
0x127LFUNCהפניה לפונקציהפונקציה חיצונית (למשל bank.withdraw)
0x128LFIELDx is required [as Type]שדה חובה
0x129LALIASsee a from pathכינוי של חבילה שיובאה
0x12ALGROUP1. רשימה ממוספרתקבוצת ביצוע מסודרת

0x126L~0x12AL הם קודים ישירים של משפחת Edge פורמט TOULMIN (TOULMIN).

פריסה

ID               רשומת LOCAL Reference (Edge Id)
כותרת 1 WORD     role 2b | Reserved 2b | F_GROUNDS 1b | level 2b | סוג object 2b | flags 7b
[F_FUNC]         FuncRef: REF(ALIAS, או 0 אם אין) + VerbCode ב-WORD אחד
[F_QUAL]         SIGNED-DECIMAL Value. Qualifier
[F_CHECK]        REF(מקרה)
[F_CLAIM]        Claim: REF(subject) + predicate ב-WORD אחד + object + mode ב-WORD אחד
[F_VERDICT]      SIGNED-DECIMAL Value. ערך התחלתי של ערך פסק הדין
[F_WITH]         מספר (UNSIGNED-INTEGER Value) + REF(TEXT) × מספר
[F_GROUNDS]      מספר (UNSIGNED-INTEGER Value) + REF(TEXT) × מספר
SPAN             הרוחב שקבע SOURCE × 2 (בייט התחלה, מספר בייטים)

WORD כותרת

ביטיםשדהערך
15–14role0 general, 1 counter, 2 except
13–12Reserved0
11F_GROUNDSיש רשימת ראיות
10–9level0 Unset, 1 Fail, 2 Review (3 Reserved)
8–7סוג objectצורת ה-object של Claim. 0 REF, 1 UNSIGNED-INTEGER Value, 2 SPAN
6–0flagsהטבלה להלן
ביטflagמשמעות
b0F_FUNCיש שדה FuncRef
b1F_QUALיש שדה Qualifier
b2F_CHECKיש שדה מקרה יעד של checking
b3F_CLAIMיש שדה Claim
b4F_VERDICTיש שדה ערך התחלתי של ערך פסק הדין
b5F_STRIKEהצהרה שנמחקה בקו חוצה. אין שדה
b6F_WITHיש שדה רשימת קריטריונים
  • השדות המותנים מסודרים לפי סדר ה-flags (F_FUNC, F_QUAL, F_CHECK, F_CLAIM, F_VERDICT, F_WITH, F_GROUNDS). שדה שה-flag שלו כבוי אינו תופס מקום.
  • אם flag דלוק ואין שדה, דוחים. המיקום שאליו הגיעה קריאת השדות לפי הסדר, אחרי SPAN, חייב להתיישר בדיוק עם סוף הרשומה.

שדות

שדההסבר
FuncRefמקום הפונקציה. REF הוא רשומת ALIAS שייבאה את הפונקציה, ואם הפונקציה שייכת למסמך הזה הוא 0. VerbCode הוא קוד ב-WORD אחד שעדיין לא הוקצה (0x0000 מותר). הכתיב המקורי של הפונקציה נכתב בנפרד כ-TEXT + LABEL
Qualifierרמת הביטחון של הצומת (0~1)
מקרהF_CHECK: המקרה שהצומת הזה רק פוסק בו (checking c)
Claimהטענה שהצומת נושא. REF של subject, predicate ב-WORD אחד, object, ו-mode ב-WORD אחד. צורת ה-object נקבעת לפי סוג ה-object בכותרת
ערך פסק דיןערך התחלתי של ערך פסק הדין (−1~1)
F_WITHקריטריון השיפוט בזמן ההצהרה (기준으로 하는, «המשתמש בקריטריון»). רשימת REF של רשומות TEXT
F_GROUNDSשמות עובדות חיצוניות שנפתרות בזמן ההערכה (근거로 하는, «המסתמך על»). רשימת REF של רשומות TEXT
SPANטווח טקסט המקור שממנו יצאה ההצהרה
  • רישום ערך פסק הדין וה-Qualifier נקבע לפי הכללים המספריים של TOULMIN.
  • מספר הפריטים ברשימה הוא רשומת UNSIGNED-INTEGER Value משובצת.
  • הצורה הבסיסית של Claim תיאורי היא subject ו-predicate ‏0 ו-object ‏SPAN (סוג object 2). והיא מקובעת לכתיב המקורי.

פירוש ותוקף

  • ב-RULE·COUNTER·EXCEPT-DECLARE, ה-role חייב להיות זהה ל-Codec (0 general, 1 counter, 2 except). ב-SPEC-DECLARE הוא סוג ההגדרה. בשאר ה-Codec הוא 0.
  • אם level הוא 0 (Unset), משתמשים בברירת המחדל של המנוע: Fail ב-COUNTER-DECLARE, ו-Review ב-EXCEPT-DECLARE.
  • כלל פונקציית המארח של TANGEUL ‏tangl:규칙 (쓰는 규칙이다, «כלל שמשתמש בפונקציה») נכתב כ-NODE של RULE-DECLARE מחוץ למקרה. הפונקציה ב-F_FUNC, הקריטריון ב-F_WITH, והראיות ב-F_GROUNDS. רק בכלל של ביטוי תנאי מניחים לפניו PREDICATE-DECLARE.
  • ביטי Reserved (13–12) חייבים להיות 0. אם ביט Reserved דלוק, או שה-role אינו תואם ל-Codec, דוחים.

דפים קשורים

LINK היא פריסה שכותבת קשרים בין צמתים בגרף TOULMIN. סוג הקשר נקבע לפי ה-Codec.

Codec

CodecשםTANGEULsrc → dst
0x108LATTACKSdon't X when Yכלל → כלל. מקטין בהדרגה את הפסק בעוצמת התקיפה
0x109LSUPERSEDESX supersedes Yכלל → כלל. אם Active, מוציא את היעד מהצבירה
0x110LRUNrun c when nכלל → מקרה
0x111LDOdo fn when nכלל → FuncRef
0x112LDO-ONCEdo fn once when nכלל → FuncRef
0x113LUNDOundo fn when nכלל → FuncRef
0x114LCHECKINGchecking cכלל → מקרה. פסק דין ללא תופעות לוואי
0x12BLREQUIRESf is requiredמקרה → שדה
0x12CLMEANSDefinitions ‏meansפריט הגדרה → ערך או טיפוס
0x12DLHASDefinitions ‏hasפריט הגדרה → שדה
0x12ELRUNSנקודת כניסה run cנקודת כניסה → מקרה (ביצוע)
0x12FLEVALUATESנקודת כניסה check cנקודת כניסה → מקרה (פסק דין)
0x130LTRIGGERSטריגר run cטריגר → מקרה
0x131LUNTILevery … until cטריגר → מקרה
0x132LSAME-ASצומת → מזהה גלובלי
0x133LIMPORTED-FROMsee a from pathכינוי → נתיב (TEXT)
0x134LLABELשם בגרשיים הפוכים (backtick)צומת → TEXT. סימון שם

פריסה

ID               רשומת LOCAL Reference (Edge Id)
src              REF
dst              REF. ב-DO·DO-ONCE·UNDO הוא FuncRef
flags 1 WORD     b0 F_ONCE, b1 F_GATE, b2 F_STRIKE, b3 F_ORDERED, b4 F_FORCE
[F_GATE]         אופרטור ב-WORD אחד (2 הביטים העליונים) + UNSIGNED-DECIMAL Value (אחוזים)
[F_FORCE]        SIGNED-DECIMAL Value. עוצמת תקיפה (0~1). ATTACKS בלבד
SPAN             הרוחב שקבע SOURCE × 2
flagמשמעות
b0 F_ONCEמבוצע פעם אחת בלבד (ה-once של UNDO)
b1 F_GATEיש שדה שער ביטחון
b2 F_STRIKEקשר שנמחק בקו חוצה
b3 F_ORDEREDשייך לרשימה ממוספרת 1.
b4 F_FORCEיש שדה עוצמת תקיפה. ATTACKS בלבד
אופרטור שערמשמעות
0at least
1above
2less than
3at most
  • השדות המותנים מסודרים לפי סדר ה-flags (F_GATE, F_FORCE). שדה שה-flag שלו כבוי אינו תופס מקום.

עוצמת תקיפה

עוצמת תקיפה (F_FORCE) משמשת רק את ATTACKS. נוסחת פסק הדין, הכתיב והדוגמה נמצאים שם.

פירוש ותוקף

  • REF הוא Edge Id של רשומה במסמך הזה (שדות משותפים של TOULMIN).
  • צורת ה-dst נקבעת לפי ה-Codec. ב-DO·DO-ONCE·UNDO הוא FuncRef (REF(ALIAS, או 0 אם אין) + VerbCode ב-WORD אחד, NODE), ב-LABEL·IMPORTED-FROM הוא REF של רשומת TEXT, ובשאר הוא REF של צומת.
  • do … once מיוצג על ידי ה-Codec DO-ONCE. ב-flags של DO-ONCE לא משתמשים ב-F_ONCE (אם הוא מודלק, דוחים). ה-once של UNDO נכתב ב-F_ONCE.
  • אופרטור השער הוא 2 הביטים העליונים של ה-WORD של האופרטור, ו-14 הביטים הנותרים הם 0. האחוז הוא UNSIGNED-DECIMAL Value עם E=0, בטווח 0~100.
  • ביטים b5~b15 של flags הם Reserved וחייבים להיות 0. אחרת דוחים.
  • F_FORCE משמש רק ב-ATTACKS. אם הוא מודלק ב-Codec אחר (SUPERSEDES, חיבורי ביצוע ופסק דין, קשרי פורמט TOULMIN), דוחים.
  • אם עוצמת התקיפה אינה SIGNED-DECIMAL Value, או מחוץ ל-0~1, או שאי אפשר לייצג אותה במדויק בארבע ספרות אחרי הנקודה, דוחים.
  • שרשרת A > B > C של SUPERSEDES נכתבת ב-SUPERSEDES אחד לכל זוג.

דפים קשורים

SOURCE ומקטעים

רשומות שכותבות את טקסט המקור והחלוקה למקטעים של מסמך TOULMIN. כולן קודים ישירים 0x120L~0x125L של משפחת Edge פורמט TOULMIN (TOULMIN). אין שדות Issuer ומספר Codec, וה-Payload בא אחרי ה-TAG.

פורמט

Codecשםפריסה
0x120LSOURCEID, WORD רוחב SPAN, UTF8 Value
0x121LTEXTID, UTF8 Value
0x122LSECTIONID, קוד קטע ב-WORD אחד
0x123LCASE-BEGINID, REF (מקרה)
0x124LCASE-ENDID, REF (מקרה)
0x125LPROSEID, SPAN
  • ID הוא Edge Id, ו-REF הוא ה-Edge Id של רשומת המסמך הזו (שדות משותפים של TOULMIN).
  • UTF8 Value היא רשומת UTF8-TEXT Value. היא נושאת את הבייטים כפי שהם.

דפים לפי פורמט

לכל פורמט יש דף משלו עם הפריסה, טבלת קודי הקטעים והפירוש.

  • SOURCE: טקסט המקור של הכתיבה. הרשומה הראשונה ב-BODY, וקובעת את רוחב ה-SPAN
  • TEXT: שם או מחרוזת
  • SECTION: תחילת קטע וקוד הקטע
  • CASE-BEGIN, CASE-END: טווח המקרה
  • PROSE: פסקת תיאור

דפים קשורים