diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
index 2118864f..4d69335a 100644
--- a/.github/workflows/main.yml
+++ b/.github/workflows/main.yml
@@ -15,7 +15,7 @@ jobs:
- uses: actions/checkout@v2
- uses: actions/setup-node@v1
with:
- node-version: "12.x"
+ node-version: "14.x"
- uses: c-hive/gha-yarn-cache@v1
- run: yarn install --frozen-lockfile
- run: yarn lint
@@ -29,7 +29,7 @@ jobs:
- uses: actions/checkout@v2
- uses: actions/setup-node@v1
with:
- node-version: "12.x"
+ node-version: "14.x"
- uses: c-hive/gha-yarn-cache@v1
- run: yarn install --frozen-lockfile
- run: yarn test --coverage
@@ -50,7 +50,7 @@ jobs:
- uses: actions/checkout@v2
- uses: actions/setup-node@v1
with:
- node-version: "12.x"
+ node-version: "14.x"
- uses: c-hive/gha-yarn-cache@v1
- run: yarn install --frozen-lockfile
- run: yarn lint
@@ -66,7 +66,7 @@ jobs:
- uses: actions/checkout@v2
- uses: actions/setup-node@v1
with:
- node-version: "12.x"
+ node-version: "14.x"
- uses: c-hive/gha-yarn-cache@v1
- run: yarn install --frozen-lockfile
- run: yarn test --coverage --forceExit
@@ -87,7 +87,7 @@ jobs:
- uses: actions/checkout@v2
- uses: actions/setup-node@v1
with:
- node-version: "12.x"
+ node-version: "14.x"
- uses: c-hive/gha-yarn-cache@v1
- run: yarn install --frozen-lockfile
- run: yarn lint
@@ -101,7 +101,7 @@ jobs:
- uses: actions/checkout@v2
- uses: actions/setup-node@v1
with:
- node-version: "12.x"
+ node-version: "14.x"
- uses: c-hive/gha-yarn-cache@v1
- run: yarn install --frozen-lockfile
- run: yarn test --coverage
diff --git a/.github/workflows/spotlight-staging.yml b/.github/workflows/spotlight-staging.yml
index bbcf1caf..566832c9 100644
--- a/.github/workflows/spotlight-staging.yml
+++ b/.github/workflows/spotlight-staging.yml
@@ -19,7 +19,7 @@ jobs:
- uses: actions/checkout@v2
- uses: actions/setup-node@v1
with:
- node-version: "12.x"
+ node-version: "14.x"
- uses: c-hive/gha-yarn-cache@v1
- name: Install dependencies
run: yarn install --frozen-lockfile
diff --git a/.nvmrc b/.nvmrc
index be43e15f..54844bc4 100644
--- a/.nvmrc
+++ b/.nvmrc
@@ -1 +1 @@
-12.*
+14.*
diff --git a/public-dashboard-client/package.json b/public-dashboard-client/package.json
index e2684952..8a6717bb 100644
--- a/public-dashboard-client/package.json
+++ b/public-dashboard-client/package.json
@@ -38,10 +38,10 @@
"empty-lite": "^1.0.3",
"env-cmd": "^10.1.0",
"prop-types": "^15.7.2",
- "react": "^16.13.1",
+ "react": "^17.0.0",
"react-app-polyfill": "^1.0.6",
"react-collapsed": "^3.0.0",
- "react-dom": "^16.13.1",
+ "react-dom": "^17.0.0",
"react-helmet": "^6.1.0",
"react-measure": "^2.3.0",
"react-scripts": "3.4.3",
@@ -72,7 +72,8 @@
"development": [
"last 1 chrome version",
"last 1 firefox version",
- "last 1 safari version"
+ "last 1 safari version",
+ "ie 11"
]
},
"resolutions": {
diff --git a/spotlight-api/.nvmrc b/spotlight-api/.nvmrc
new file mode 100644
index 00000000..776c1a01
--- /dev/null
+++ b/spotlight-api/.nvmrc
@@ -0,0 +1 @@
+10.*
\ No newline at end of file
diff --git a/spotlight-client/package.json b/spotlight-client/package.json
index caa323e8..fee6c792 100644
--- a/spotlight-client/package.json
+++ b/spotlight-client/package.json
@@ -17,6 +17,7 @@
"dependencies": {
"@auth0/auth0-spa-js": "^1.13.1",
"@reach/router": "^1.3.4",
+ "@recidiviz/case-triage-components": "^0.2.2",
"@types/classnames": "^2.2.11",
"@types/d3-array": "^2.8.0",
"@types/d3-color": "^2.0.1",
@@ -32,8 +33,8 @@
"@types/lodash.xor": "^4.5.6",
"@types/qs": "^6.9.5",
"@types/reach__router": "^1.3.6",
- "@types/react": "^16.9.0",
- "@types/react-dom": "^16.9.0",
+ "@types/react": "^17.0.0",
+ "@types/react-dom": "^17.0.0",
"@types/react-measure": "^2.0.6",
"@types/react-portal": "^4.0.2",
"@types/react-simple-maps": "^1.0.3",
@@ -65,15 +66,16 @@
"mobx-utils": "^6.0.1",
"polished": "^4.0.5",
"qs": "^6.9.4",
- "react": "^16.13.1",
+ "react": "^17.0.0",
"react-app-polyfill": "^1.0.6",
"react-collapsed": "^3.0.1",
- "react-dom": "^16.13.1",
+ "react-dom": "^17.0.0",
"react-error-boundary": "^3.0.2",
"react-helmet-async": "^1.0.7",
"react-intersection-observer": "^8.31.0",
"react-is": "^16.13.1",
"react-measure": "^2.5.2",
+ "react-modal": "^3.12.1",
"react-portal": "^4.2.1",
"react-scripts": "3.4.3",
"react-simple-maps": "^2.3.0",
diff --git a/spotlight-client/src/MetricVizControls/MetricVizControls.test.tsx b/spotlight-client/src/MetricVizControls/MetricVizControls.test.tsx
new file mode 100644
index 00000000..ddf34068
--- /dev/null
+++ b/spotlight-client/src/MetricVizControls/MetricVizControls.test.tsx
@@ -0,0 +1,69 @@
+// Recidiviz - a data platform for criminal justice reform
+// Copyright (C) 2021 Recidiviz, Inc.
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program. If not, see .
+// =============================================================================
+
+import { fireEvent, render, screen, within } from "@testing-library/react";
+import React from "react";
+import createMetricMapping from "../contentModels/createMetricMapping";
+import HistoricalPopulationBreakdownMetric from "../contentModels/HistoricalPopulationBreakdownMetric";
+import contentFixture from "../contentModels/__fixtures__/tenant_content_exhaustive";
+import MetricVizControls from "./MetricVizControls";
+
+const testTenantId = "US_ND";
+const testMetricId = "ProbationPopulationHistorical";
+const testMetadataMapping = {
+ [testMetricId]: contentFixture.metrics[testMetricId],
+};
+
+// we can use any metric here, the behavior is generic
+function getTestMetric() {
+ return createMetricMapping({
+ localityLabelMapping: undefined,
+ metadataMapping: testMetadataMapping,
+ tenantId: testTenantId,
+ }).get(testMetricId) as HistoricalPopulationBreakdownMetric;
+}
+
+test("download button", () => {
+ const metric = getTestMetric();
+ jest.spyOn(metric, "download").mockImplementation(() => Promise.resolve());
+
+ render();
+
+ const download = screen.getByRole("button", { name: "Download Data" });
+ expect(download).toBeVisible();
+ fireEvent.click(download);
+
+ expect(metric.download).toHaveBeenCalled();
+});
+
+test("methodology modal", () => {
+ const metric = getTestMetric();
+ render();
+
+ const methodology = screen.getByRole("button", { name: "Methodology" });
+
+ fireEvent.click(methodology);
+
+ const modal = screen.getByRole("dialog");
+
+ expect(modal).toBeVisible();
+ expect(
+ within(modal).getByRole("heading", { name: "Methodology" })
+ ).toBeVisible();
+ // this only works because the test metric has no HTML in it
+ expect(within(modal).getByText(metric.methodology)).toBeVisible();
+});
diff --git a/spotlight-client/src/MetricVizControls/MetricVizControls.tsx b/spotlight-client/src/MetricVizControls/MetricVizControls.tsx
index 4d29f187..9ce09c49 100644
--- a/spotlight-client/src/MetricVizControls/MetricVizControls.tsx
+++ b/spotlight-client/src/MetricVizControls/MetricVizControls.tsx
@@ -15,13 +15,15 @@
// along with this program. If not, see .
// =============================================================================
+import HTMLReactParser from "html-react-parser";
import { rem } from "polished";
-import React from "react";
+import React, { useState } from "react";
import styled from "styled-components/macro";
import downloadPath from "../assets/cloud-download.svg";
+import machineLearningPath from "../assets/machine-learning.svg";
import Metric from "../contentModels/Metric";
import { MetricRecord } from "../contentModels/types";
-import { colors, zIndex } from "../UiLibrary";
+import { colors, CopyBlock, Modal, ModalHeading, zIndex } from "../UiLibrary";
const Wrapper = styled.div`
background: ${colors.background};
@@ -50,7 +52,7 @@ const FilterWrapper = styled.div`
}
`;
-const DownloadButton = styled.button`
+const Button = styled.button`
background: none;
border: none;
color: ${colors.link};
@@ -60,13 +62,18 @@ const DownloadButton = styled.button`
padding: none;
`;
-const DownloadIcon = styled.img.attrs({ src: downloadPath })`
+const ButtonIcon = styled.img`
height: ${rem(16)};
/* icon needs minor adjustment to align with text */
margin-bottom: ${rem(-2)};
width: ${rem(16)};
`;
+const MethodologyCopy = styled(CopyBlock)`
+ line-height: 1.7;
+ margin-top: ${rem(16)};
+`;
+
type MetricVizControlsProps = {
filters: React.ReactElement[];
metric: Metric;
@@ -76,6 +83,8 @@ const MetricVizControls = ({
filters,
metric,
}: MetricVizControlsProps): React.ReactElement => {
+ const [showMethodology, setShowMethodology] = useState(false);
+
return (
@@ -87,9 +96,21 @@ const MetricVizControls = ({
))}
- metric.download()}>
- Download Data
-
+
+
+ setShowMethodology(false)}
+ >
+ Methodology
+
+ {HTMLReactParser(metric.methodology)}
+
+
);
diff --git a/spotlight-client/src/UiLibrary/Modal.tsx b/spotlight-client/src/UiLibrary/Modal.tsx
new file mode 100644
index 00000000..948dd11e
--- /dev/null
+++ b/spotlight-client/src/UiLibrary/Modal.tsx
@@ -0,0 +1,58 @@
+// Recidiviz - a data platform for criminal justice reform
+// Copyright (C) 2021 Recidiviz, Inc.
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program. If not, see .
+// =============================================================================
+
+import { Modal as ModalBase } from "@recidiviz/case-triage-components";
+import { rem, rgba } from "polished";
+import styled from "styled-components/macro";
+import { colors } from ".";
+import animation from "./animation";
+import zIndex from "./zIndex";
+
+export const Modal = styled(ModalBase).attrs({
+ closeTimeoutMS: animation.defaultDuration,
+})`
+ /*
+ the double ampersands are a trick to overcome
+ specificity in the imported component styles
+ */
+ && .ReactModal__Overlay {
+ background: ${rgba(colors.modalOverlay, 0)};
+ transition: background-color ${animation.defaultDuration}ms,
+ backdrop-filter ${animation.defaultDuration}ms;
+ z-index: ${zIndex.modal};
+
+ &.ReactModal__Overlay--after-open {
+ /* not all browsers support backdrop-filter but it's a nice progressive enhancement */
+ backdrop-filter: blur(${rem(4)});
+ background: ${rgba(colors.modalOverlay, 0.7)};
+ }
+
+ &.ReactModal__Overlay--before-close {
+ backdrop-filter: none;
+ background: ${rgba(colors.modalOverlay, 0)};
+ }
+ }
+
+ && .ReactModal__Content {
+ max-height: 90vh;
+ max-width: 90vw;
+ overflow: auto;
+ z-index: ${zIndex.modal + 1};
+ }
+`;
+
+export { ModalHeading } from "@recidiviz/case-triage-components";
diff --git a/spotlight-client/src/UiLibrary/colors.ts b/spotlight-client/src/UiLibrary/colors.ts
index 77bedd01..352e76e8 100644
--- a/spotlight-client/src/UiLibrary/colors.ts
+++ b/spotlight-client/src/UiLibrary/colors.ts
@@ -57,6 +57,7 @@ export default {
menuButtonOpen: pineBright,
mobileMenuBackground: pineDark,
mobileMenuRule: pine,
+ modalOverlay: gray,
rule: gray,
ruleHover: "#AFC1C3",
text: pine,
diff --git a/spotlight-client/src/UiLibrary/index.ts b/spotlight-client/src/UiLibrary/index.ts
index 475af188..939a79c3 100644
--- a/spotlight-client/src/UiLibrary/index.ts
+++ b/spotlight-client/src/UiLibrary/index.ts
@@ -23,6 +23,7 @@ export { default as CopyBlock } from "./CopyBlock";
export { default as colors } from "./colors";
export * from "./Dropdown";
export { default as FixedBottomPanel } from "./FixedBottomPanel";
+export * from "./Modal";
export { default as PageSection } from "./PageSection";
export * from "./typography";
export { default as zIndex } from "./zIndex";
diff --git a/spotlight-client/src/assets/machine-learning.svg b/spotlight-client/src/assets/machine-learning.svg
new file mode 100644
index 00000000..aa5e8d7e
--- /dev/null
+++ b/spotlight-client/src/assets/machine-learning.svg
@@ -0,0 +1,11 @@
+
diff --git a/spotlight-client/src/contentApi/sources/methodologyBoilerplate.ts b/spotlight-client/src/contentApi/sources/methodologyBoilerplate.ts
new file mode 100644
index 00000000..c8e5997d
--- /dev/null
+++ b/spotlight-client/src/contentApi/sources/methodologyBoilerplate.ts
@@ -0,0 +1,26 @@
+// Recidiviz - a data platform for criminal justice reform
+// Copyright (C) 2021 Recidiviz, Inc.
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program. If not, see .
+// =============================================================================
+
+export const ageGroup = `In distributions by age, individuals are counted towards the
+age group they fall into as of the reporting date.`;
+
+export const gender = `Gender distributions only include male and female due to
+low numbers of other reported genders.`;
+
+export const raceOrEthnicity = `Distributions by race count individuals with more than
+one reported race or ethnicity towards the racial or ethnic identity that is least
+represented in the general population.`;
diff --git a/spotlight-client/src/contentApi/sources/us_nd.ts b/spotlight-client/src/contentApi/sources/us_nd.ts
index b7788a27..5d4a2787 100644
--- a/spotlight-client/src/contentApi/sources/us_nd.ts
+++ b/spotlight-client/src/contentApi/sources/us_nd.ts
@@ -16,6 +16,7 @@
// =============================================================================
import { TenantContent } from "../types";
+import { ageGroup, gender, raceOrEthnicity } from "./methodologyBoilerplate";
import programRegionsTopology from "./usNdProgramRegions";
// localities for both sentencing and probation
@@ -32,6 +33,45 @@ const judicialDistricts = [
{ id: "OTHER", label: "Other" },
];
+const demographicsBoilerplate = `
${ageGroup} ${gender} ${raceOrEthnicity}
+The “Other” category includes Asian and Native Hawaiian or other Pacific Islander
+individuals due to low counts of these reported racial identities in North Dakota.
`;
+
+const sentencingBoilerplate = `
District selection filters the data to only individuals
+whose sentence was imposed by a judge from a particular judicial district. Individuals are
+linked to the judicial district associated with their charge (for individuals sentenced to
+incarceration) or to the judicial district that encompasses the county in which
+their offense took place (for individuals sentenced to probation). Some individuals have
+multiple sentences resulting from multiple charges. When this occurs, one charge is considered
+the “controlling” charge, meaning the sentence associated with this charge is currently the
+most restrictive sentence being served. For individuals currently incarcerated, the sentence
+associated with the controlling charge determines the judicial district in which the person is
+counted. Individuals on supervision are counted in each judicial district for which they
+are serving a sentence.
`;
+
+const prisonBoilerplate = `
This data concerns individuals in prison in North Dakota.
+It does not include individuals incarcerated in county jails.
`;
+
+const probationBoilerplate = `
This data may include some individuals on probation in North
+Dakota as part of the interstate compact program, in which North Dakota agrees to supervise
+individuals who were charged and sentenced in a different state, but have a compelling reason
+to serve their probation in North Dakota. Under the same program, individuals placed on probation
+from a North Dakota court may occasionally serve their probation in a different state.
`;
+
+const probationDistrictBoilerplate = `
The districts associated with this data indicate individuals
+whose probation sentence was imposed by a judge from a particular judicial district, determined by the
+judicial district that encompasses the county in which the offense took place.
`;
+
+const paroleBoilerplate = `
This data may include some individuals on parole in North
+Dakota as part of the interstate compact program, in which North Dakota agrees to supervise
+the release of individuals who were charged, sentenced, and incarcerated in a different state,
+but have a compelling reason to serve their parole in North Dakota. Under the same program,
+individuals paroled from a North Dakota prison may occasionally serve their parole in a
+different state.
`;
+
+const paroleOfficerBoilerplate = `
The offices associated with this data indicate individuals
+who are being supervised by a parole officer stationed in that office.
`;
+
const content: TenantContent = {
name: "North Dakota",
description:
@@ -58,120 +98,226 @@ const content: TenantContent = {
SentencePopulationCurrent: {
name: "Sentenced Population",
description: "description TK",
- methodology:
- "This includes all individuals that are currently incarcerated, on parole, or on probation in North Dakota.",
+ methodology: `This data includes all individuals that are currently incarcerated, on parole, or on probation
+ in North Dakota. ${demographicsBoilerplate} ${sentencingBoilerplate}`,
totalLabel: "Total people sentenced",
},
SentenceTypesCurrent: {
name: "Sentence Types",
description: "description TK",
- methodology:
- "Incarceration includes any sentence that begins with a period of incarceration in a ND DOCR facility. Probation includes any sentence that begins with a period of probation under the supervision of a ND DOCR probation officer.
Of note, individuals’ current status (incarcerated or on supervision) may differ from their sentence category (incarceration or probation). Individuals now on parole after being incarcerated are still counted in the incarceration sentence category. Individuals who have had their probation revoked and are now in prison are likewise included in the probation sentence category because their sentence was first to probation.
It is possible for an individual to be serving both incarceration and probation sentences simultaneously. These individuals are counted in the “Both” category.
",
+ methodology: `Incarceration includes any sentence that begins with a period of incarceration in a ND DOCR facility.
+ Probation includes any sentence that begins with a period of probation under the supervision of a
+ ND DOCR probation officer.
Of note, individuals’ current status (incarcerated or on supervision)
+ may differ from their sentence category (incarceration or probation). Individuals now on parole after
+ being incarcerated are still counted in the incarceration sentence category. Individuals who have had
+ their probation revoked and are now in prison are likewise included in the probation sentence category
+ because their sentence was first to probation.
It is possible for an individual to be serving both
+ incarceration and probation sentences simultaneously. These individuals are counted in the “Both” category.
+ ${demographicsBoilerplate} ${sentencingBoilerplate}`,
},
PrisonPopulationCurrent: {
name: "Current Prison Population",
description: "description TK",
- methodology:
- "This includes all individuals that are currently incarcerated in a ND DOCR facility. It does not include individuals incarcerated in county jails nor individuals currently serving their prison sentence in the community through the Community Placement Program.",
+ methodology: `This data includes all individuals that are currently incarcerated in a ND DOCR facility.
+ It does not include individuals incarcerated in county jails nor individuals currently
+ serving their prison sentence in the community through the Community Placement Program.
+ ${demographicsBoilerplate} ${prisonBoilerplate}`,
totalLabel: "Total people in prison",
},
PrisonPopulationHistorical: {
name: "Historical Prison Population",
description: "description TK",
- methodology:
- "This chart shows the number of people that were incarcerated in a ND DOCR facility on the first day of each month over the last 20 years. It does not include individuals incarcerated in county jails nor individuals serving their prison sentence in the community through the Community Placement Program.",
+ methodology: `This data includes the number of people that were incarcerated in a ND DOCR facility on the
+ first day of each month over the last 20 years. It does not include individuals incarcerated
+ in county jails nor individuals serving their prison sentence in the community through the
+ Community Placement Program. ${demographicsBoilerplate} ${prisonBoilerplate}`,
},
PrisonAdmissionReasonsCurrent: {
name: "Reason for Incarceration",
description: "description TK",
- methodology:
- "This shows the original reason for admission for all individuals currently incarcerated in a ND DOCR facility. When an individual is admitted to a state prison, the reason for the admission is documented by prison officials. These categories are pulled from that documentation.",
+ methodology: `This data includes the original reason for admission for all individuals currently incarcerated
+ in a ND DOCR facility. When an individual is admitted to a state prison, the reason for the admission
+ is documented by prison officials. These categories are pulled from that documentation.
+ ${demographicsBoilerplate} ${prisonBoilerplate}`,
},
PrisonStayLengthAggregate: {
name: "Length of Prison Stay",
description: "description TK",
- methodology:
- "This graph shows how long (in years) individuals spent in prison prior to their first official release for a specific sentence. It includes individuals released in the past 3 years who, prior to release, were serving a new sentence of incarceration or were incarcerated due to revocation of probation. It excludes individuals incarcerated due to revocation of parole. Individuals released from prison for a reason other than completion of sentence, commutation of sentence, parole, or death are also excluded. Of note, this graph does include time spent in the Community Placement Program prior to release as part of time served. Individuals serving life sentences will only be included upon their death.",
+ methodology: `This data reports how long (in years) individuals spent in prison prior to their
+ first official release for a specific sentence. It includes individuals released
+ in the past 3 years who, prior to release, were serving a new sentence of
+ incarceration or were incarcerated due to revocation of probation. It excludes
+ individuals incarcerated due to revocation of parole. Individuals released from
+ prison for a reason other than completion of sentence, commutation of sentence,
+ parole, or death are also excluded. Of note, this data does include time spent
+ in the Community Placement Program prior to release as part of time served.
+ Individuals serving life sentences will only be included upon their death.
+ ${demographicsBoilerplate} ${prisonBoilerplate}`,
},
PrisonReleaseTypeAggregate: {
name: "Placement After Prison",
description: "description TK",
- methodology:
- "This includes all individuals released in the last 3 years, including releases directly from the Community Placement Program. When an individual is released from a state prison, the reason for the release is documented by prison officials. These categories are pulled from that documentation. Facility release reasons that do not typically correlate with an end to the period of incarceration, such as transfers between facilities, are not shown here.",
+ methodology: `This data includes all individuals released in the last 3 years, including releases
+ directly from the Community Placement Program. When an individual is released from a
+ state prison, the reason for the release is documented by prison officials. These
+ categories are pulled from that documentation. Facility release reasons that do not
+ typically correlate with an end to the period of incarceration, such as transfers
+ between facilities, are not shown here. ${demographicsBoilerplate} ${prisonBoilerplate}`,
},
PrisonRecidivismRateHistorical: {
name: "Cumulative Recidivism Rates",
description: "description TK",
- methodology:
- "This chart shows reincarceration recidivism rates, which is the proportion of individuals released from a ND DOCR facility that return to a ND DOCR facility at some point in the future. The releases are grouped by the calendar year in which the release occurred, and the rates are calculated as the percentage of the people released that have returned to incarceration after each year since the release. Individuals are included in the release cohort if they were released for serving their sentence or were conditionally released onto supervision. Admissions to incarceration for new court commitments or due to revocations of supervision are counted as instances of reincarceration recidivism.",
+ methodology: `This data reports reincarceration recidivism rates, which is the proportion of individuals
+ released from a ND DOCR facility that return to a ND DOCR facility at some point in the
+ future. The releases are grouped by the calendar year in which the release occurred, and
+ the rates are calculated as the percentage of the people released that have returned to
+ incarceration after each year since the release. Individuals are included in the release
+ cohort if they were released for serving their sentence or were conditionally released into
+ supervision. Admissions to incarceration for new court commitments or due to revocations of
+ supervision are counted as instances of reincarceration recidivism. ${demographicsBoilerplate}
+ ${prisonBoilerplate}`,
},
PrisonRecidivismRateSingleFollowupHistorical: {
name: "Recidivism Rates Over Time",
description: "description TK",
- methodology:
- "This chart shows the reincarceration recidivism rate for a set number years since the release, for the 10 most recent release cohorts.",
+ methodology: `This data reports the reincarceration recidivism rate for a set number of years
+ since the release, for the 10 most recent release cohorts. ${demographicsBoilerplate}
+ ${prisonBoilerplate}`,
},
ProbationPopulationCurrent: {
name: "Current Probation Population",
description: "description TK",
- methodology:
- "This visualization counts people currently on probation in North Dakota.",
+ methodology: `This data includes people currently on probation in North Dakota.
+ ${demographicsBoilerplate} ${probationBoilerplate} ${probationDistrictBoilerplate}`,
totalLabel: "Total people on probation",
},
ProbationPopulationHistorical: {
name: "Historical Probation Population",
description: "description TK",
- methodology:
- "This chart shows the number of people that were on probation in North Dakota on the first day of each month over the last 20 years.",
+ methodology: `This data includes the number of people that were on probation in
+ North Dakota on the first day of each month over the last 20 years.
+ ${demographicsBoilerplate} ${probationBoilerplate}`,
},
ProbationSuccessHistorical: {
name: "Historical Probation Completion Rates",
description: "description TK",
- methodology:
- "This chart looks at the percent of people projected to complete probation in a given month who have successfully completed probation by the end of that month.
Probation is considered successfully completed if the individual is discharged from probation positively or if a probation period expires. Unsuccessful completion of probation occurs when probation ends due to absconsion, revocation, or negative termination. Deaths, suspensions, and terminations marked as “other” are excluded from these calculations because they are neither successful nor unsuccessful.
Individuals whose probation is terminated prior to their projected completion month are counted in the month in which their probation is scheduled to complete, while individuals who have not yet completed probation by their projected completion date are excluded. For example, if 15 people are projected to complete probation in 12 months, 5 are revoked this month, 3 are discharged early in 8 months, 2 complete parole in 12 months, and 5 do not complete probation, the completion rate in 12 months will be 50%, as 10 of the people projected to complete probation will have actually completed probation, 5 of them successfully.
",
+ methodology: `This data reports the percentage of people projected to complete probation
+ in a given month who have successfully completed probation by the end of that month.
+
Probation is considered successfully completed if the individual is discharged from
+ probation positively or if a probation period expires. Unsuccessful completion of probation
+ occurs when probation ends due to absconsion, revocation, or negative termination. Deaths,
+ suspensions, and terminations marked as “other” are excluded from these calculations because
+ they are neither successful nor unsuccessful.
Individuals whose probation is terminated
+ prior to their projected completion month are counted in the month in which their probation
+ is scheduled to complete, while individuals who have not yet completed probation by their
+ projected completion date are excluded. For example, if 15 people are projected to
+ complete probation in 12 months, 5 are revoked this month, 3 are discharged early in
+ 8 months, 2 complete parole in 12 months, and 5 do not complete probation, the completion
+ rate in 12 months will be 50%, as 10 of the people projected to complete probation will
+ have actually completed probation, 5 of them successfully.
${demographicsBoilerplate}
+ ${probationBoilerplate} ${probationDistrictBoilerplate}`,
},
ProbationRevocationsAggregate: {
name: "Reasons for Probation Revocation",
description: "description TK",
- methodology:
- "This chart counts people who were incarcerated in a DOCR facility within the last 3 years because their probation was revoked. Revocations are included based on the date that the person was admitted to a DOCR facility because their probation was revoked, not the date of the probation case closure or causal violation or offense.
Revocation admissions are linked to supervision cases closed via revocation within 90 days of the admission. Each individual is counted once, even if they had multiple violation reasons or revocation proceedings from multiple supervision cases. If an individual had their probation revoked multiple times in the last 3 years, the most recent revocation is counted. When an individual does have multiple violation types leading to revocation, only the most severe violation is displayed. New offenses are considered more severe than absconsions, which are considered more severe than technical violations. Violations of “Unknown Type” indicate individuals who were admitted to prison for a supervision revocation where the violation that caused the revocation cannot yet be determined. Revocation admissions without a supervision case closed via revocation in the 90 day window will always be considered of “Unknown Type”.
Individuals occasionally serve probation and parole sentences simultaneously. For revoked individuals in this situation, their revocation admission is categorized as either a probation or a parole revocation, depending on who authorized the revocation admission (the parole board for parole revocations or the sentencing judge for probation revocations). This chart counts only individuals with probation revocation admissions. Individuals on both parole and probation with a parole revocation admission are included in the parole page.
",
+ methodology: `This data includes people who were incarcerated in a DOCR facility within the last
+ 3 years because their probation was revoked. Revocations are included based on the
+ date that the person was admitted to a DOCR facility because their probation was
+ revoked, not the date of the probation case closure or causal violation or offense.
+
Revocation admissions are linked to supervision cases closed via revocation within
+ 90 days of the admission. Each individual is counted once, even if they had multiple
+ violation reasons or revocation proceedings from multiple supervision cases. If an
+ individual had their probation revoked multiple times in the last 3 years, the most
+ recent revocation is counted. When an individual does have multiple violation types
+ leading to revocation, only the most severe violation is displayed. New offenses are
+ considered more severe than absconsions, which are considered more severe than technical
+ violations. Violations of “Unknown Type” indicate individuals who were admitted to prison
+ for a supervision revocation where the violation that caused the revocation cannot yet be
+ determined. Revocation admissions without a supervision case closed via revocation in the
+ 90 day window will always be considered of “Unknown Type”.
Individuals occasionally
+ serve probation and parole sentences simultaneously. For revoked individuals in this situation,
+ their revocation admission is categorized as either a probation or a parole revocation,
+ depending on who authorized the revocation admission (the parole board for parole
+ revocations or the sentencing judge for probation revocations). This data includes
+ only individuals with probation revocation admissions. Individuals on both parole
+ and probation with a parole revocation admission are included in the parole page.
+ ${demographicsBoilerplate} ${probationBoilerplate}`,
},
ProbationProgrammingCurrent: {
name: "Free Through Recovery Program Participation in Probation",
description: "description TK",
- methodology:
- "This chart counts the total number of people on probation who are actively enrolled in Free Through Recovery (FTR). Free Through Recovery is run jointly with the Department of Health and Human Services (DHS): as a result, FTR enrollment is aggregated into the 8 DHS service regions of the provider locations at which individuals are enrolled.",
+ methodology: `This data includes the total number of people on probation who are actively
+ enrolled in Free Through Recovery (FTR). Free Through Recovery is run jointly
+ with the Department of Health and Human Services (DHS): as a result, FTR enrollment
+ is aggregated into the 8 DHS service regions of the provider locations at which
+ individuals are enrolled. ${probationBoilerplate}`,
},
ParolePopulationCurrent: {
name: "Current Parole Population",
description: "description TK",
- methodology:
- "This visualization counts people currently on parole in North Dakota.",
+ methodology: `This data includes people currently on parole in North Dakota.
+ ${demographicsBoilerplate} ${paroleBoilerplate} ${paroleOfficerBoilerplate}`,
totalLabel: "Total people on parole",
},
ParolePopulationHistorical: {
name: "Historical Parole Population",
description: "description TK",
- methodology:
- "This chart shows the number of people that were on parole in North Dakota on the first day of each month over the last 20 years.",
+ methodology: `This data includes the number of people that were on parole in North Dakota
+ on the first day of each month over the last 20 years. ${demographicsBoilerplate}
+ ${paroleBoilerplate}`,
},
ParoleSuccessHistorical: {
name: "Historical Parole Completion Rates",
description: "description TK",
- methodology:
- "This chart looks at the percent of people projected to complete parole in a given month who have successfully completed parole by the end of that month.
Parole is considered successfully completed if an individual is discharged from parole positively or if a parole period expires. Unsuccessful completions of parole occur when the parole ends due to absconsion, a revocation, or a negative termination. Deaths, suspensions, and terminations marked as “other” are excluded from these calculations because they are neither successful nor unsuccessful.
Individuals whose parole is terminated prior to their projected completion month are counted in the month in which their parole is scheduled to complete, while individuals who have not yet completed parole by their projected completion date are excluded. For example, if 15 people are projected to complete parole in 12 months, 5 are revoked this month, 3 are discharged early in 8 months, 2 complete parole in 12 months, and 5 do not complete parole, the completion rate in 12 months will be 50%, as 10 of the people projected to complete parole will have actually completed parole, 5 of them successfully.
",
+ methodology: `This data reports the percentage of people projected to complete parole
+ in a given month who have successfully completed parole by the end of that month.
+
Parole is considered successfully completed if an individual is discharged from
+ parole positively or if a parole period expires. Unsuccessful completions of parole occur
+ when the parole ends due to absconsion, a revocation, or a negative termination. Deaths,
+ suspensions, and terminations marked as “other” are excluded from these calculations
+ because they are neither successful nor unsuccessful.
Individuals whose parole
+ is terminated prior to their projected completion month are counted in the month in
+ which their parole is scheduled to complete, while individuals who have not yet
+ completed parole by their projected completion date are excluded. For example, if 15
+ people are projected to complete parole in 12 months, 5 are revoked this month, 3
+ are discharged early in 8 months, 2 complete parole in 12 months, and 5 do not
+ complete parole, the completion rate in 12 months will be 50%, as 10 of the people
+ projected to complete parole will have actually completed parole, 5 of them
+ successfully.
${demographicsBoilerplate} ${paroleBoilerplate}`,
},
ParoleRevocationsAggregate: {
name: "Reasons for Parole Revocation",
description: "description TK",
- methodology:
- "This chart counts people who were incarcerated in a DOCR facility within the last 3 years because their parole was revoked. Revocations are included based on the date that the person was admitted to a DOCR facility because their parole was revoked, not the date of the parole case closure or causal violation or offense.
Revocation admissions are linked to parole cases closed via revocation within 90 days of the admission. Each individual is counted once, even if they had multiple violation reasons or revocation proceedings from multiple supervision cases. If an individual has had their parole revoked multiple times in the last 3 years, the most recent revocation is counted. When an individual does have multiple violation types leading to revocation, only the most severe violation is displayed. New offenses are considered more severe than absconsions, which are considered more severe than technical violations. Violations of “Unknown Type” indicate individuals who were admitted to prison for a supervision revocation where the violation that caused the revocation cannot yet be determined. Revocation admissions without a supervision case closed via revocation in the 90 day window will always be considered of “Unknown Type”.
Individuals occasionally serve probation and parole sentences simultaneously. For revoked individuals in this situation, their revocation admission is categorized as either a probation or a parole revocation, depending on who authorized the revocation admission (the parole board for parole revocations or the sentencing judge for probation revocations). This chart counts only individuals with parole revocation admissions. Individuals on both parole and probation with a probation revocation admission are included in the probation page.
",
+ methodology: `This data includes people who were incarcerated in a DOCR facility within the
+ last 3 years because their parole was revoked. Revocations are included based on the date
+ that the person was admitted to a DOCR facility because their parole was revoked, not the
+ date of the parole case closure or causal violation or offense.
Revocation admissions
+ are linked to parole cases closed via revocation within 90 days of the admission. Each
+ individual is counted once, even if they had multiple violation reasons or revocation
+ proceedings from multiple supervision cases. If an individual has had their parole revoked
+ multiple times in the last 3 years, the most recent revocation is counted. When an
+ individual does have multiple violation types leading to revocation, only the most
+ severe violation is displayed. New offenses are considered more severe than absconsions,
+ which are considered more severe than technical violations. Violations of “Unknown Type”
+ indicate individuals who were admitted to prison for a supervision revocation where the
+ violation that caused the revocation cannot yet be determined. Revocation admissions
+ without a supervision case closed via revocation in the 90 day window will always be
+ considered of “Unknown Type”.
Individuals occasionally serve probation and parole
+ sentences simultaneously. For revoked individuals in this situation, their revocation
+ admission is categorized as either a probation or a parole revocation, depending on
+ who authorized the revocation admission (the parole board for parole revocations or
+ the sentencing judge for probation revocations). This data includes only individuals
+ with parole revocation admissions. Individuals on both parole and probation with a
+ probation revocation admission are included in the probation page.