1"use strict";(self.webpackChunkabstrackr_docs=self.webpackChunkabstrackr_docs||[]).push([["877"],{4143(e,s,t){t.r(s),t.d(s,{metadata:()=>l,default:()=>h,frontMatter:()=>r,contentTitle:()=>a,toc:()=>o,assets:()=>d});var l=JSON.parse('{"id":"reference/citation-status","title":"Citation Status","description":"Every citation carries a single status value, computed automatically whenever a label or resolution label is inserted, updated, or deleted. Application code never writes to the status column directly.","source":"@site/docs/reference/citation-status.md","sourceDirName":"reference","slug":"/reference/citation-status","permalink":"/docs/reference/citation-status","draft":false,"unlisted":false,"tags":[],"version":"current","sidebarPosition":3,"frontMatter":{"sidebar_position":3,"title":"Citation Status"},"sidebar":"docsSidebar","previous":{"title":"Screening Modes","permalink":"/docs/reference/screening-modes"},"next":{"title":"Blinding Mode","permalink":"/docs/reference/blinding"}}'),n=t(4848),i=t(8453);let r={sidebar_position:3,title:"Citation Status"},a="Citation Status",d={},o=[{value:"Status values",id:"status-values",level:2},{value:"Resolution labels take absolute priority",id:"resolution-labels-take-absolute-priority",level:2},{value:"Status computation rules (in evaluation order)",id:"status-computation-rules-in-evaluation-order",level:2},{value:"How blinding affects visible status",id:"how-blinding-affects-visible-status",level:2}];function c(e){let s={a:"a",code:"code",em:"em",h1:"h1",h2:"h2",header:"header",li:"li",ol:"ol",p:"p",strong:"strong",table:"table",tbody:"tbody",td:"td",th:"th",thead:"thead",tr:"tr",...(0,i.R)(),...e.components};return(0,n.jsxs)(n.Fragment,{children:[(0,n.jsx)(s.header,{children:(0,n.jsx)(s.h1,{id:"citation-status",children:"Citation Status"})}),"\n",(0,n.jsx)(s.p,{children:"Every citation carries a single status value, computed automatically whenever a label or resolution label is inserted, updated, or deleted. Application code never writes to the status column directly."}),"\n",(0,n.jsxs)(s.p,{children:["The status is ",(0,n.jsx)(s.strong,{children:"project-wide"})," \u2014 it is a single value shared across all members and all screening contexts. It is not per-user and not per-set."]}),"\n",(0,n.jsx)(s.h2,{id:"status-values",children:"Status values"}),"\n",(0,n.jsxs)(s.table,{children:[(0,n.jsx)(s.thead,{children:(0,n.jsxs)(s.tr,{children:[(0,n.jsx)(s.th,{children:"Status"}),(0,n.jsx)(s.th,{children:"Meaning"})]})}),(0,n.jsxs)(s.tbody,{children:[(0,n.jsxs)(s.tr,{children:[(0,n.jsx)(s.td,{children:(0,n.jsx)(s.code,{children:"unscreened"})}),(0,n.jsx)(s.td,{children:"No labels and no resolution labels. Also applies when the number of labels received is below the current screening-mode threshold."})]}),(0,n.jsxs)(s.tr,{children:[(0,n.jsx)(s.td,{children:(0,n.jsx)(s.code,{children:"included"})}),(0,n.jsxs)(s.td,{children:["Threshold met; all labels are ",(0,n.jsx)(s.strong,{children:"Yes"})," (value = 1)."]})]}),(0,n.jsxs)(s.tr,{children:[(0,n.jsx)(s.td,{children:(0,n.jsx)(s.code,{children:"excluded"})}),(0,n.jsxs)(s.td,{children:["Threshold met; all labels are ",(0,n.jsx)(s.strong,{children:"No"})," (value = \u22121)."]})]}),(0,n.jsxs)(s.tr,{children:[(0,n.jsx)(s.td,{children:(0,n.jsx)(s.code,{children:"conflict"})}),(0,n.jsxs)(s.td,{children:["At least one ",(0,n.jsx)(s.strong,{children:"Maybe"})," (value = 0) is present, OR the threshold is met and both Yes and No labels exist (reviewers disagreed). A single Maybe from a single reviewer is sufficient to create a conflict, regardless of mode."]})]}),(0,n.jsxs)(s.tr,{children:[(0,n.jsx)(s.td,{children:(0,n.jsx)(s.code,{children:"resolved_included"})}),(0,n.jsxs)(s.td,{children:["One or more resolution labels exist; all are ",(0,n.jsx)(s.strong,{children:"Include"})," (value = 1)."]})]}),(0,n.jsxs)(s.tr,{children:[(0,n.jsx)(s.td,{children:(0,n.jsx)(s.code,{children:"resolved_excluded"})}),(0,n.jsxs)(s.td,{children:["One or more resolution labels exist; all are ",(0,n.jsx)(s.strong,{children:"Exclude"})," (value = \u22121)."]})]}),(0,n.jsxs)(s.tr,{children:[(0,n.jsx)(s.td,{children:(0,n.jsx)(s.code,{children:"resolved_conflict"})}),(0,n.jsx)(s.td,{children:"Multiple resolution labels exist and they contradict each other (one resolver voted Include, another voted Exclude). Requires further arbitration."})]})]})]}),"\n",(0,n.jsx)(s.h2,{id:"resolution-labels-take-absolute-priority",children:"Resolution labels take absolute priority"}),"\n",(0,n.jsxs)(s.p,{children:["If any resolution label exists on a citation, the ",(0,n.jsx)(s.code,{children:"resolved_*"})," statuses override all regular labels. Deleting all regular labels while a resolution label remains keeps the status as ",(0,n.jsx)(s.code,{children:"resolved_*"}),". The ",(0,n.jsx)(s.code,{children:"resolved_*"})," states are unaffected by mode changes."]}),"\n",(0,n.jsx)(s.h2,{id:"status-computation-rules-in-evaluation-order",children:"Status computation rules (in evaluation order)"}),"\n",(0,n.jsxs)(s.ol,{children:["\n",(0,n.jsxs)(s.li,{children:["If any resolution label exists \u2192 evaluate resolution labels \u2192 ",(0,n.jsx)(s.code,{children:"resolved_included"}),", ",(0,n.jsx)(s.code,{children:"resolved_excluded"}),", or ",(0,n.jsx)(s.code,{children:"resolved_conflict"}),"."]}),"\n",(0,n.jsxs)(s.li,{children:["Else if any regular label has value = 0 (Maybe) \u2192 ",(0,n.jsx)(s.code,{children:"conflict"}),"."]}),"\n",(0,n.jsxs)(s.li,{children:["Else if the number of regular labels < mode threshold \u2192 ",(0,n.jsx)(s.code,{children:"unscreened"}),"."]}),"\n",(0,n.jsxs)(s.li,{children:["Else if both Yes and No labels are present \u2192 ",(0,n.jsx)(s.code,{children:"conflict"}),"."]}),"\n",(0,n.jsxs)(s.li,{children:["Else if all labels are Yes \u2192 ",(0,n.jsx)(s.code,{children:"included"}),"."]}),"\n",(0,n.jsxs)(s.li,{children:["Else if all labels are No \u2192 ",(0,n.jsx)(s.code,{children:"excluded"}),"."]}),"\n"]}),"\n",(0,n.jsx)(s.h2,{id:"how-blinding-affects-visible-status",children:"How blinding affects visible status"}),"\n",(0,n.jsxs)(s.p,{children:["Blinding does ",(0,n.jsx)(s.strong,{children:"not"})," change the computed status value \u2014 the trigger uses all labels from all members regardless. What blinding changes is which labels and who submitted them are ",(0,n.jsx)(s.em,{children:"displayed"})," in the screening interface and in CSV/RIS exports. A citation may show as ",(0,n.jsx)(s.code,{children:"included"})," to the system while a blinded reviewer cannot see any labels other than their own. See ",(0,n.jsx)(s.a,{href:"/docs/reference/blinding",children:"Blinding Mode"})," for details."]})]})}function h(e={}){let{wrapper:s}={...(0,i.R)(),...e.components};return s?(0,n.jsx)(s,{...e,children:(0,n.jsx)(c,{...e})}):c(e)}},8453(e,s,t){t.d(s,{R:()=>r,x:()=>a});
1var l=t(6540);let n={},i=l.createContext(n);function r(e){let s=l.useContext(i);return l.useMemo(function(){return"function"==typeof e?e(s):{...s,...e}},[s,e])}function a(e){let s;return s=e.disableParentContext?"function"==typeof e.components?e.components(n):e.components||n:r(e.components),l.createElement(i.Provider,{value:s},e.children)}}}]);
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.