כותב גרף פסק דין וביצוע לפי מודל הטיעון של טולמין. זו משפחת הליבה שבאמצעותה 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 | משמעות |
|---|---|---|---|---|
0x100L | CASE-DECLARE | NODE | in case of | הצהרת מקרה. גרף פסק דין שנושא צמתים וקשרים |
0x101L | PREDICATE-DECLARE | EXPR | ביטוי תנאי ב-Rules | הצהרת פרדיקט. ביטוי פסק דין |
0x102L | SPEC-DECLARE | NODE | פריט Definitions | הצהרת קריטריון שיפוט (Backing). ביט ה-role קובע את סוג ההגדרה |
0x103L | RULE-DECLARE | NODE | general rule, שם הכלל ב-Rules | הצהרת טענה (Warrant). אפשר לתקוף אותה |
0x104L | COUNTER-DECLARE | NODE | counter rule | הצהרת ראיית נגד. תוקפת עם מסקנה משלה. ה-Level המשתמע הוא Fail |
0x105L | EXCEPT-DECLARE | NODE | except rule | הצהרת חריג. תוקף ללא מסקנה משלו. ה-Level המשתמע הוא Review |
0x108L | ATTACKS | LINK | don't X when Y | יחס תקיפה. פסק התוקף מקטין בהדרגה את פסק היעד בעוצמת התקיפה (0~1, ברירת מחדל 1) |
0x109L | SUPERSEDES | LINK | X supersedes Y | יחס הדרה. אם התוקף Active, הוא מוציא את היעד מהצבירה באופן מכריע. שרשרת (A > B > C) נכתבת בקשר אחד לכל זוג |
0x10AL | SUPERSEDE-CHAIN | — | שרשרת עדיפויות A > B > C. קיצור של SUPERSEDES לפי זוגות. הוקצה רק הקוד, ועדיין אין פריסה | |
0x110L | RUN | LINK | run c when n | הרכבת ביצוע. אם הצומת Active, מריצים את המקרה התחתון (DAG) |
0x111L | DO | LINK | do fn when n | פעולה שמבוצעת כשהצומת Active |
0x112L | DO-ONCE | LINK | do fn once when n | פעולה שמבוצעת פעם אחת בלבד גם בניסיון חוזר |
0x113L | UNDO | LINK | undo fn when n | פעולת פיצוי של DO (saga). אם שלב מאוחר יותר נכשל, מבוצעת בסדר הפוך |
0x114L | CHECKING | LINK | checking c | חיבור שרק פוסק, ללא תופעות לוואי |
0x115L | ENTRY | NODE | provides x | נקודת כניסה חיצונית. מריצה או פוסקת מקרה |
0x116L | TRIGGER | NODE | on, every, until | נקודת כניסה של אירוע או מחזור, ללא קריאה חיצונית |
0x118L | VERDICT | — | תוצאת פסק הדין של צומת או רשומה. תוצאה (Pass, Review, Fail), ערך פסק דין, Activated, Excluded, Level. הוקצה רק הקוד, ועדיין אין פריסה | |
0x119L | EVIDENCE | — | ראיה לפסק הדין. מיקום, ערך צפוי, ערך בפועל (Fact). הוקצה רק הקוד, ועדיין אין פריסה | |
0x11CL~0x11FL | Reserved |
- קודים ישירים שאינם בטבלה (
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 | שם | פריסה | משמעות |
|---|---|---|---|
0x120L | SOURCE | ID, WORD רוחב SPAN, UTF8 Value | טקסט המקור של הכתיבה |
0x121L | TEXT | ID, UTF8 Value | שם או מחרוזת |
0x122L | SECTION | ID, קוד קטע ב-WORD אחד | תחילת קטע |
0x123L | CASE-BEGIN | ID, REF (מקרה) | תחילת טווח המקרה |
0x124L | CASE-END | ID, REF (מקרה) | סוף טווח המקרה |
0x125L | PROSE | ID, SPAN | פסקת תיאור |
0x126L | NAMESPACE | NODE | this document is |
0x127L | FUNC | NODE | הפניה לפונקציה |
0x128L | FIELD | NODE | is required |
0x129L | ALIAS | NODE | see … from |
0x12AL | GROUP | NODE | קבוצת ביצוע מסודרת |
0x12BL | REQUIRES | LINK | מקרה → שדה |
0x12CL | MEANS | LINK | פריט הגדרה → ערך או טיפוס |
0x12DL | HAS | LINK | פריט הגדרה → שדה |
0x12EL | RUNS | LINK | נקודת כניסה → מקרה, ביצוע |
0x12FL | EVALUATES | LINK | נקודת כניסה → מקרה, פסק דין |
0x130L | TRIGGERS | LINK | טריגר → מקרה |
0x131L | UNTIL | LINK | טריגר → מקרה (every … until) |
0x132L | SAME-AS | LINK | צומת → מזהה גלובלי |
0x133L | IMPORTED-FROM | LINK | כינוי → נתיב (TEXT) |
0x134L | LABEL | LINK | צומת → 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 Reference | Edge 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 empty | is not empty | equals / is in / השוואת גודל |
|---|---|---|---|
| ערך v | שקר | אמת | מוערך לפי v |
| NO-VALUE (אין) | אמת | שקר | שקר |
| UNKNOWN-VALUE (לא ידוע) | שקר | אמת | לא מוכרע (U) |
| ABSENT (לא נכתב) / היעדר היגד | U (עולם פתוח) | U | U |
- הלוגיקה היא 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 | צומת |
|---|---|---|---|
0x100L | CASE-DECLARE | in case of | מקרה |
0x102L | SPEC-DECLARE | פריטי Definitions (means, has) | קריטריון שיפוט (Backing). ה-role הוא סוג ההגדרה |
0x103L | RULE-DECLARE | general rule | טענה (Warrant) |
0x104L | COUNTER-DECLARE | counter rule | ראיית נגד (Rebuttal) |
0x105L | EXCEPT-DECLARE | except rule | חריג (Defeater) |
0x115L | ENTRY | provides x | נקודת כניסה חיצונית |
0x116L | TRIGGER | on, every, until | נקודת כניסה של אירוע או מחזור |
0x126L | NAMESPACE | this document is | מרחב השמות של המסמך |
0x127L | FUNC | הפניה לפונקציה | פונקציה חיצונית (למשל bank.withdraw) |
0x128L | FIELD | x is required [as Type] | שדה חובה |
0x129L | ALIAS | see a from path | כינוי של חבילה שיובאה |
0x12AL | GROUP | 1. רשימה ממוספרת | קבוצת ביצוע מסודרת |
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–14 | role | 0 general, 1 counter, 2 except |
| 13–12 | Reserved | 0 |
| 11 | F_GROUNDS | יש רשימת ראיות |
| 10–9 | level | 0 Unset, 1 Fail, 2 Review (3 Reserved) |
| 8–7 | סוג object | צורת ה-object של Claim. 0 REF, 1 UNSIGNED-INTEGER Value, 2 SPAN |
| 6–0 | flags | הטבלה להלן |
| ביט | flag | משמעות |
|---|---|---|
| b0 | F_FUNC | יש שדה FuncRef |
| b1 | F_QUAL | יש שדה Qualifier |
| b2 | F_CHECK | יש שדה מקרה יעד של checking |
| b3 | F_CLAIM | יש שדה Claim |
| b4 | F_VERDICT | יש שדה ערך התחלתי של ערך פסק הדין |
| b5 | F_STRIKE | הצהרה שנמחקה בקו חוצה. אין שדה |
| b6 | F_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
LINK היא פריסה שכותבת קשרים בין צמתים בגרף TOULMIN. סוג הקשר נקבע לפי ה-Codec.
Codec
| Codec | שם | TANGEUL | src → dst |
|---|---|---|---|
0x108L | ATTACKS | don't X when Y | כלל → כלל. מקטין בהדרגה את הפסק בעוצמת התקיפה |
0x109L | SUPERSEDES | X supersedes Y | כלל → כלל. אם Active, מוציא את היעד מהצבירה |
0x110L | RUN | run c when n | כלל → מקרה |
0x111L | DO | do fn when n | כלל → FuncRef |
0x112L | DO-ONCE | do fn once when n | כלל → FuncRef |
0x113L | UNDO | undo fn when n | כלל → FuncRef |
0x114L | CHECKING | checking c | כלל → מקרה. פסק דין ללא תופעות לוואי |
0x12BL | REQUIRES | f is required | מקרה → שדה |
0x12CL | MEANS | Definitions means | פריט הגדרה → ערך או טיפוס |
0x12DL | HAS | Definitions has | פריט הגדרה → שדה |
0x12EL | RUNS | נקודת כניסה run c | נקודת כניסה → מקרה (ביצוע) |
0x12FL | EVALUATES | נקודת כניסה check c | נקודת כניסה → מקרה (פסק דין) |
0x130L | TRIGGERS | טריגר run c | טריגר → מקרה |
0x131L | UNTIL | every … until c | טריגר → מקרה |
0x132L | SAME-AS | צומת → מזהה גלובלי | |
0x133L | IMPORTED-FROM | see a from path | כינוי → נתיב (TEXT) |
0x134L | LABEL | שם בגרשיים הפוכים (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 בלבד |
| אופרטור שער | משמעות |
|---|---|
| 0 | at least |
| 1 | above |
| 2 | less than |
| 3 | at 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 | שם | פריסה |
|---|---|---|
0x120L | SOURCE | ID, WORD רוחב SPAN, UTF8 Value |
0x121L | TEXT | ID, UTF8 Value |
0x122L | SECTION | ID, קוד קטע ב-WORD אחד |
0x123L | CASE-BEGIN | ID, REF (מקרה) |
0x124L | CASE-END | ID, REF (מקרה) |
0x125L | PROSE | ID, SPAN |
- ID הוא Edge Id, ו-REF הוא ה-Edge Id של רשומת המסמך הזו (שדות משותפים של TOULMIN).
- UTF8 Value היא רשומת UTF8-TEXT Value. היא נושאת את הבייטים כפי שהם.
דפים לפי פורמט
לכל פורמט יש דף משלו עם הפריסה, טבלת קודי הקטעים והפירוש.
- SOURCE: טקסט המקור של הכתיבה. הרשומה הראשונה ב-BODY, וקובעת את רוחב ה-SPAN
- TEXT: שם או מחרוזת
- SECTION: תחילת קטע וקוד הקטע
- CASE-BEGIN, CASE-END: טווח המקרה
- PROSE: פסקת תיאור