Compare commits

..

No commits in common. '8e2769dc0e23d5df6790632ce72c408fb72940e7' and '5fbf9af28659ae04c6981569746014563928d396' have entirely different histories.

Binary file not shown.

Before

Width:  |  Height:  |  Size: 15 KiB

After

Width:  |  Height:  |  Size: 3.8 KiB

@ -20,8 +20,6 @@ import ProfiledUnitsComponent from "./ProfiledUnits";
import ThermalUnitsComponent from "./ThermalUnits"; import ThermalUnitsComponent from "./ThermalUnits";
import TransmissionLinesComponent from "./TransmissionLines"; import TransmissionLinesComponent from "./TransmissionLines";
import { UnitCommitmentScenario } from "../../core/Data/types"; import { UnitCommitmentScenario } from "../../core/Data/types";
import StorageComponent from "./StorageUnits";
import PriceSensitiveLoadsComponent from "./Psload";
export interface CaseBuilderSectionProps { export interface CaseBuilderSectionProps {
scenario: UnitCommitmentScenario; scenario: UnitCommitmentScenario;
@ -32,13 +30,7 @@ export interface CaseBuilderSectionProps {
const CaseBuilder = () => { const CaseBuilder = () => {
const [scenario, setScenario] = useState(() => { const [scenario, setScenario] = useState(() => {
const savedScenario = localStorage.getItem("scenario"); const savedScenario = localStorage.getItem("scenario");
if (!savedScenario) return BLANK_SCENARIO; return savedScenario ? JSON.parse(savedScenario) : BLANK_SCENARIO;
const [processedScenario, err] = preprocess(JSON.parse(savedScenario));
if (err) {
console.log(err);
return BLANK_SCENARIO;
}
return processedScenario!!;
}); });
const [undoStack, setUndoStack] = useState<UnitCommitmentScenario[]>([]); const [undoStack, setUndoStack] = useState<UnitCommitmentScenario[]>([]);
const [toastMessage, setToastMessage] = useState<string>(""); const [toastMessage, setToastMessage] = useState<string>("");
@ -120,16 +112,6 @@ const CaseBuilder = () => {
onDataChanged={onDataChanged} onDataChanged={onDataChanged}
onError={setToastMessage} onError={setToastMessage}
/> />
<StorageComponent
scenario={scenario}
onDataChanged={onDataChanged}
onError={setToastMessage}
/>
<PriceSensitiveLoadsComponent
scenario={scenario}
onDataChanged={onDataChanged}
onError={setToastMessage}
/>
<TransmissionLinesComponent <TransmissionLinesComponent
scenario={scenario} scenario={scenario}
onDataChanged={onDataChanged} onDataChanged={onDataChanged}

@ -174,7 +174,7 @@ const ProfiledUnitsComponent = (props: CaseBuilderSectionProps) => {
return ( return (
<div> <div>
<SectionHeader title="Profiled units"> <SectionHeader title="Profiled Units">
<SectionButton icon={faPlus} tooltip="Add" onClick={onAdd} /> <SectionButton icon={faPlus} tooltip="Add" onClick={onAdd} />
<SectionButton <SectionButton
icon={faDownload} icon={faDownload}

@ -1,175 +0,0 @@
/*
* UnitCommitment.jl: Optimization Package for Security-Constrained Unit Commitment
* Copyright (C) 2020-2025, UChicago Argonne, LLC. All rights reserved.
* Released under the modified BSD license. See COPYING.md for more details.
*/
import DataTable, {
ColumnSpec,
generateCsv,
generateTableColumns,
generateTableData,
parseCsv,
} from "../Common/Forms/DataTable";
import { CaseBuilderSectionProps } from "./CaseBuilder";
import { useRef } from "react";
import FileUploadElement from "../Common/Buttons/FileUploadElement";
import { ValidationError } from "../../core/Data/validate";
import SectionHeader from "../Common/SectionHeader/SectionHeader";
import SectionButton from "../Common/Buttons/SectionButton";
import {
faDownload,
faPlus,
faUpload,
} from "@fortawesome/free-solid-svg-icons";
import { UnitCommitmentScenario } from "../../core/Data/types";
import { ColumnDefinition } from "tabulator-tables";
import {
changePriceSensitiveLoadData,
createPriceSensitiveLoad,
deletePriceSensitiveLoad,
renamePriceSensitiveLoad,
} from "../../core/Operations/psloadOps";
import { offerDownload } from "../Common/io";
export const PriceSensitiveLoadsColumnSpec: ColumnSpec[] = [
{
title: "Name",
type: "string",
width: 100,
},
{
title: "Bus",
type: "busRef",
width: 100,
},
{
title: "Revenue ($/MW)",
type: "number",
width: 100,
},
{
title: "Demand (MW)",
type: "number[T]",
width: 70,
},
];
export const generatePriceSensitiveLoadsData = (
scenario: UnitCommitmentScenario,
): [any[], ColumnDefinition[]] => {
const columns = generateTableColumns(scenario, PriceSensitiveLoadsColumnSpec);
const data = generateTableData(
scenario["Price-sensitive loads"],
PriceSensitiveLoadsColumnSpec,
scenario,
);
return [data, columns];
};
const PriceSensitiveLoadsComponent = (props: CaseBuilderSectionProps) => {
const fileUploadElem = useRef<FileUploadElement>(null);
const onDownload = () => {
const [data, columns] = generatePriceSensitiveLoadsData(props.scenario);
const csvContents = generateCsv(data, columns);
offerDownload(csvContents, "text/csv", "psloads.csv");
};
const onUpload = () => {
fileUploadElem.current!.showFilePicker((csv: any) => {
// Parse provided CSV file
const [psloads, err] = parseCsv(
csv,
PriceSensitiveLoadsColumnSpec,
props.scenario,
);
// Handle validation errors
if (err) {
props.onError(err.message);
return;
}
// Generate new scenario
props.onDataChanged({
...props.scenario,
"Price-sensitive loads": psloads,
});
});
};
const onAdd = () => {
const [newScenario, err] = createPriceSensitiveLoad(props.scenario);
if (err) {
props.onError(err.message);
return;
}
props.onDataChanged(newScenario);
};
const onDelete = (name: string): ValidationError | null => {
const newScenario = deletePriceSensitiveLoad(name, props.scenario);
props.onDataChanged(newScenario);
return null;
};
const onDataChanged = (
name: string,
field: string,
newValue: string,
): ValidationError | null => {
const [newScenario, err] = changePriceSensitiveLoadData(
name,
field,
newValue,
props.scenario,
);
if (err) {
props.onError(err.message);
return err;
}
props.onDataChanged(newScenario);
return null;
};
const onRename = (
oldName: string,
newName: string,
): ValidationError | null => {
const [newScenario, err] = renamePriceSensitiveLoad(
oldName,
newName,
props.scenario,
);
if (err) {
props.onError(err.message);
return err;
}
props.onDataChanged(newScenario);
return null;
};
return (
<div>
<SectionHeader title="Price-sensitive loads">
<SectionButton icon={faPlus} tooltip="Add" onClick={onAdd} />
<SectionButton
icon={faDownload}
tooltip="Download"
onClick={onDownload}
/>
<SectionButton icon={faUpload} tooltip="Upload" onClick={onUpload} />
</SectionHeader>
<DataTable
onRowDeleted={onDelete}
onRowRenamed={onRename}
onDataChanged={onDataChanged}
generateData={() => generatePriceSensitiveLoadsData(props.scenario)}
/>
<FileUploadElement ref={fileUploadElem} accept=".csv" />
</div>
);
};
export default PriceSensitiveLoadsComponent;

@ -1,235 +0,0 @@
/*
* UnitCommitment.jl: Optimization Package for Security-Constrained Unit Commitment
* Copyright (C) 2020-2025, UChicago Argonne, LLC. All rights reserved.
* Released under the modified BSD license. See COPYING.md for more details.
*/
import DataTable, {
ColumnSpec,
generateCsv,
generateTableColumns,
generateTableData,
parseCsv,
} from "../Common/Forms/DataTable";
import { CaseBuilderSectionProps } from "./CaseBuilder";
import { useRef } from "react";
import FileUploadElement from "../Common/Buttons/FileUploadElement";
import { ValidationError } from "../../core/Data/validate";
import SectionHeader from "../Common/SectionHeader/SectionHeader";
import SectionButton from "../Common/Buttons/SectionButton";
import {
faDownload,
faPlus,
faUpload,
} from "@fortawesome/free-solid-svg-icons";
import { UnitCommitmentScenario } from "../../core/Data/types";
import { ColumnDefinition } from "tabulator-tables";
import {
changeStorageUnitData,
createStorageUnit,
deleteStorageUnit,
renameStorageUnit,
} from "../../core/Operations/storageOps";
import { offerDownload } from "../Common/io";
export const StorageUnitsColumnSpec: ColumnSpec[] = [
{
title: "Name",
type: "string",
width: 100,
},
{
title: "Bus",
type: "busRef",
width: 100,
},
{
title: "Minimum level (MWh)",
type: "number",
width: 100,
},
{
title: "Maximum level (MWh)",
type: "number",
width: 100,
},
{
title: "Charge cost ($/MW)",
type: "number",
width: 100,
},
{
title: "Discharge cost ($/MW)",
type: "number",
width: 100,
},
{
title: "Charge efficiency",
type: "number",
width: 100,
},
{
title: "Discharge efficiency",
type: "number",
width: 100,
},
{
title: "Loss factor",
type: "number",
width: 80,
},
{
title: "Minimum charge rate (MW)",
type: "number",
width: 140,
},
{
title: "Maximum charge rate (MW)",
type: "number",
width: 140,
},
{
title: "Minimum discharge rate (MW)",
type: "number",
width: 140,
},
{
title: "Maximum discharge rate (MW)",
type: "number",
width: 150,
},
{
title: "Initial level (MWh)",
type: "number",
width: 100,
},
{
title: "Last period minimum level (MWh)",
type: "number",
width: 160,
},
{
title: "Last period maximum level (MWh)",
type: "number",
width: 160,
},
];
export const generateStorageUnitsData = (
scenario: UnitCommitmentScenario,
): [any[], ColumnDefinition[]] => {
const columns = generateTableColumns(scenario, StorageUnitsColumnSpec);
const data = generateTableData(
scenario["Storage units"],
StorageUnitsColumnSpec,
scenario,
);
return [data, columns];
};
const StorageUnitsComponent = (props: CaseBuilderSectionProps) => {
const fileUploadElem = useRef<FileUploadElement>(null);
const onDownload = () => {
const [data, columns] = generateStorageUnitsData(props.scenario);
const csvContents = generateCsv(data, columns);
offerDownload(csvContents, "text/csv", "storage_units.csv");
};
const onUpload = () => {
fileUploadElem.current!.showFilePicker((csv: any) => {
// Parse provided CSV file
const [storageUnits, err] = parseCsv(
csv,
StorageUnitsColumnSpec,
props.scenario,
);
// Handle validation errors
if (err) {
props.onError(err.message);
return;
}
// Generate new scenario
props.onDataChanged({
...props.scenario,
"Storage units": storageUnits,
});
});
};
const onAdd = () => {
const [newScenario, err] = createStorageUnit(props.scenario);
if (err) {
props.onError(err.message);
return;
}
props.onDataChanged(newScenario);
};
const onDelete = (name: string): ValidationError | null => {
const newScenario = deleteStorageUnit(name, props.scenario);
props.onDataChanged(newScenario);
return null;
};
const onDataChanged = (
name: string,
field: string,
newValue: string,
): ValidationError | null => {
const [newScenario, err] = changeStorageUnitData(
name,
field,
newValue,
props.scenario,
);
if (err) {
props.onError(err.message);
return err;
}
props.onDataChanged(newScenario);
return null;
};
const onRename = (
oldName: string,
newName: string,
): ValidationError | null => {
const [newScenario, err] = renameStorageUnit(
oldName,
newName,
props.scenario,
);
if (err) {
props.onError(err.message);
return err;
}
props.onDataChanged(newScenario);
return null;
};
return (
<div>
<SectionHeader title="Storage units">
<SectionButton icon={faPlus} tooltip="Add" onClick={onAdd} />
<SectionButton
icon={faDownload}
tooltip="Download"
onClick={onDownload}
/>
<SectionButton icon={faUpload} tooltip="Upload" onClick={onUpload} />
</SectionHeader>
<DataTable
onRowDeleted={onDelete}
onRowRenamed={onRename}
onDataChanged={onDataChanged}
generateData={() => generateStorageUnitsData(props.scenario)}
/>
<FileUploadElement ref={fileUploadElem} accept=".csv" />
</div>
);
};
export default StorageUnitsComponent;

@ -228,7 +228,7 @@ const ThermalUnitsComponent = (props: CaseBuilderSectionProps) => {
return ( return (
<div> <div>
<SectionHeader title="Thermal units"> <SectionHeader title="Thermal Units">
<SectionButton icon={faPlus} tooltip="Add" onClick={onAdd} /> <SectionButton icon={faPlus} tooltip="Add" onClick={onAdd} />
<SectionButton <SectionButton
icon={faDownload} icon={faDownload}

@ -27,7 +27,6 @@ import {
changeTransmissionLineData, changeTransmissionLineData,
createTransmissionLine, createTransmissionLine,
deleteTransmissionLine, deleteTransmissionLine,
rebuildContingencies,
renameTransmissionLine, renameTransmissionLine,
} from "../../core/Operations/transmissionOps"; } from "../../core/Operations/transmissionOps";
import { offerDownload } from "../Common/io"; import { offerDownload } from "../Common/io";
@ -69,11 +68,6 @@ export const TransmissionLinesColumnSpec: ColumnSpec[] = [
type: "number", type: "number",
width: 60, width: 60,
}, },
{
title: "Contingency?",
type: "lineContingency",
width: 50,
},
]; ];
const generateTransmissionLinesData = ( const generateTransmissionLinesData = (
@ -99,7 +93,6 @@ const TransmissionLinesComponent = (props: CaseBuilderSectionProps) => {
const onUpload = () => { const onUpload = () => {
fileUploadElem.current!.showFilePicker((csv: any) => { fileUploadElem.current!.showFilePicker((csv: any) => {
// Parse the CSV data
const [newLines, err] = parseCsv( const [newLines, err] = parseCsv(
csv, csv,
TransmissionLinesColumnSpec, TransmissionLinesColumnSpec,
@ -109,19 +102,9 @@ const TransmissionLinesComponent = (props: CaseBuilderSectionProps) => {
props.onError(err.message); props.onError(err.message);
return; return;
} }
// Remove contingency field from line and rebuild the contingencies section
const lineContingencies = new Set<String>();
Object.entries(newLines).forEach(([lineName, line]: [string, any]) => {
if (line["Contingency?"]) lineContingencies.add(lineName);
delete line["Contingency?"];
});
const contingencies = rebuildContingencies(lineContingencies);
const newScenario = { const newScenario = {
...props.scenario, ...props.scenario,
"Transmission lines": newLines, "Transmission lines": newLines,
Contingencies: contingencies,
}; };
props.onDataChanged(newScenario); props.onDataChanged(newScenario);
}); });
@ -180,7 +163,7 @@ const TransmissionLinesComponent = (props: CaseBuilderSectionProps) => {
return ( return (
<div> <div>
<SectionHeader title="Transmission lines"> <SectionHeader title="Transmission Lines">
<SectionButton icon={faPlus} tooltip="Add" onClick={onAdd} /> <SectionButton icon={faPlus} tooltip="Add" onClick={onAdd} />
<SectionButton <SectionButton
icon={faDownload} icon={faDownload}

@ -18,7 +18,6 @@ import {
parseNumber, parseNumber,
} from "../../../core/Operations/commonOps"; } from "../../../core/Operations/commonOps";
import { UnitCommitmentScenario } from "../../../core/Data/types"; import { UnitCommitmentScenario } from "../../../core/Data/types";
import { getContingencyTransmissionLines } from "../../../core/Operations/transmissionOps";
export interface ColumnSpec { export interface ColumnSpec {
title: string; title: string;
@ -29,8 +28,7 @@ export interface ColumnSpec {
| "number[N]" | "number[N]"
| "number[T]" | "number[T]"
| "busRef" | "busRef"
| "boolean" | "boolean";
| "lineContingency";
length?: number; length?: number;
width: number; width: number;
} }
@ -54,7 +52,6 @@ export const generateTableColumns = (
}); });
break; break;
case "boolean": case "boolean":
case "lineContingency":
columns.push({ columns.push({
...columnsCommonAttrs, ...columnsCommonAttrs,
title: spec.title, title: spec.title,
@ -120,7 +117,6 @@ export const generateTableData = (
): any[] => { ): any[] => {
const data: any[] = []; const data: any[] = [];
const timeslots = generateTimeslots(scenario); const timeslots = generateTimeslots(scenario);
let contingencyLines = null;
for (const [entryName, entryData] of Object.entries(container) as [ for (const [entryName, entryData] of Object.entries(container) as [
string, string,
any, any,
@ -139,13 +135,6 @@ export const generateTableData = (
case "busRef": case "busRef":
entry[spec.title] = entryData[spec.title]; entry[spec.title] = entryData[spec.title];
break; break;
case "lineContingency":
if (contingencyLines === null) {
contingencyLines = getContingencyTransmissionLines(scenario);
console.log(contingencyLines);
}
entry[spec.title] = contingencyLines.has(entryName);
break;
case "number[T]": case "number[T]":
for (let i = 0; i < timeslots.length; i++) { for (let i = 0; i < timeslots.length; i++) {
entry[`${spec.title} ${timeslots[i]}`] = entryData[spec.title][i]; entry[`${spec.title} ${timeslots[i]}`] = entryData[spec.title][i];
@ -298,12 +287,12 @@ export const parseCsv = (
} }
break; break;
} }
case "boolean": case "boolean": {
case "lineContingency":
const [val, err] = parseBool(row[spec.title]); const [val, err] = parseBool(row[spec.title]);
if (err) return [data, { message: err.message + rowRef }]; if (err) return [data, { message: err.message + rowRef }];
data[name][spec.title] = val; data[name][spec.title] = val;
break; break;
}
default: default:
throw Error(`Unknown type: ${spec.type}`); throw Error(`Unknown type: ${spec.type}`);
} }
@ -372,7 +361,7 @@ interface DataTableProps {
function computeTableHeight(data: any[]): string { function computeTableHeight(data: any[]): string {
const numRows = data.length; const numRows = data.length;
const height = 70 + Math.max(Math.min(numRows, 15), 1) * 28; const height = 70 + Math.min(numRows, 15) * 28;
return `${height}px`; return `${height}px`;
} }
@ -381,7 +370,6 @@ const DataTable = (props: DataTableProps) => {
const tableRef = useRef<Tabulator | null>(null); const tableRef = useRef<Tabulator | null>(null);
const [isTableBuilt, setTableBuilt] = useState<Boolean>(false); const [isTableBuilt, setTableBuilt] = useState<Boolean>(false);
const [activeCell, setActiveCell] = useState<CellComponent | null>(null); const [activeCell, setActiveCell] = useState<CellComponent | null>(null);
const [currentTableData, setCurrentTableData] = useState<any[]>([]);
useEffect(() => { useEffect(() => {
const onCellEdited = (cell: CellComponent) => { const onCellEdited = (cell: CellComponent) => {
@ -419,50 +407,27 @@ const DataTable = (props: DataTableProps) => {
const height = computeTableHeight(data); const height = computeTableHeight(data);
if (tableRef.current === null) { if (tableRef.current === null) {
console.log("new Tabulator");
tableRef.current = new Tabulator(tableContainerRef.current, { tableRef.current = new Tabulator(tableContainerRef.current, {
layout: "fitColumns", layout: "fitColumns",
data: data, data: data,
columns: columns, columns: columns,
height: height, height: height,
index: "Name",
placeholder: "No data",
}); });
tableRef.current.on("tableBuilt", () => { tableRef.current.on("tableBuilt", () => {
setTableBuilt(true); setTableBuilt(true);
}); });
} }
if (isTableBuilt) { if (isTableBuilt) {
const newHeight = height; const newHeight = height;
const newColumns = columns; const newColumns = columns;
const newTableData = data; const newData = data;
const oldRows = tableRef.current.getRows(); const oldRows = tableRef.current.getRows();
const activeRowPosition = activeCell?.getRow().getPosition() as number; const activeRowPosition = activeCell?.getRow().getPosition() as number;
const activeField = activeCell?.getField(); const activeField = activeCell?.getField();
// Update data // Update data
if (newTableData.length === currentTableData.length) { tableRef.current.replaceData(newData).then(() => {});
const updatedRows = newTableData.filter((_, i) => {
return (
JSON.stringify(newTableData[i]) !==
JSON.stringify(currentTableData[i])
);
});
if (updatedRows.length > 0) {
tableRef.current
.updateData(updatedRows)
.then(() => {})
.catch((e) => {
// WORKAROUND: Updating the same row twice triggers an exception.
// In that case, we just update the whole table.
console.log(e);
tableRef.current!!.replaceData(newTableData).then(() => {});
});
}
} else {
tableRef.current.replaceData(newTableData).then(() => {});
}
setCurrentTableData(newTableData);
// Restore active cell selection // Restore active cell selection
if (activeCell) { if (activeCell) {
@ -507,6 +472,7 @@ const DataTable = (props: DataTableProps) => {
// Set new callbacks // Set new callbacks
tableRef.current.on("cellEditing", (cell) => { tableRef.current.on("cellEditing", (cell) => {
console.log("cellEditing", cell);
setActiveCell(cell); setActiveCell(cell);
}); });
@ -515,7 +481,6 @@ const DataTable = (props: DataTableProps) => {
}); });
tableRef.current.on("cellEdited", (cell) => { tableRef.current.on("cellEdited", (cell) => {
setActiveCell(null);
onCellEdited(cell); onCellEdited(cell);
}); });
} }

@ -83,14 +83,3 @@
.tabulator-col-group-cols { .tabulator-col-group-cols {
font-size: 12px; font-size: 12px;
} }
.tabulator-placeholder {
width: 100px !important;
}
.tabulator-placeholder * {
font-weight: normal !important;
font-size: 14px !important;
color: var(--contrast-60) !important;
}

@ -61,38 +61,6 @@ export const TEST_DATA_1: UnitCommitmentScenario = {
"Flow limit penalty ($/MW)": 5000.0, "Flow limit penalty ($/MW)": 5000.0,
}, },
}, },
"Storage units": {
su1: {
Bus: "b1",
"Minimum level (MWh)": 10.0,
"Maximum level (MWh)": 100.0,
"Charge cost ($/MW)": 2.0,
"Discharge cost ($/MW)": 1.0,
"Charge efficiency": 0.8,
"Discharge efficiency": 0.85,
"Loss factor": 0.01,
"Minimum charge rate (MW)": 5.0,
"Maximum charge rate (MW)": 10.0,
"Minimum discharge rate (MW)": 4.0,
"Maximum discharge rate (MW)": 8.0,
"Initial level (MWh)": 20.0,
"Last period minimum level (MWh)": 21.0,
"Last period maximum level (MWh)": 22.0,
},
},
"Price-sensitive loads": {
ps1: {
Bus: "b3",
"Revenue ($/MW)": 23.0,
"Demand (MW)": [50, 50, 50, 50, 50],
},
},
Contingencies: {
l1: {
"Affected generators": [],
"Affected lines": ["l1"],
},
},
}; };
export const TEST_DATA_2: UnitCommitmentScenario = { export const TEST_DATA_2: UnitCommitmentScenario = {
@ -107,11 +75,8 @@ export const TEST_DATA_2: UnitCommitmentScenario = {
b2: { "Load (MW)": [10, 20, 30, 40] }, b2: { "Load (MW)": [10, 20, 30, 40] },
b3: { "Load (MW)": [0, 30, 0, 40] }, b3: { "Load (MW)": [0, 30, 0, 40] },
}, },
Contingencies: {},
Generators: {}, Generators: {},
"Transmission lines": {}, "Transmission lines": {},
"Storage units": {},
"Price-sensitive loads": {},
}; };
export const TEST_DATA_BLANK: UnitCommitmentScenario = { export const TEST_DATA_BLANK: UnitCommitmentScenario = {
@ -122,11 +87,8 @@ export const TEST_DATA_BLANK: UnitCommitmentScenario = {
"Time step (min)": 60, "Time step (min)": 60,
}, },
Buses: {}, Buses: {},
Contingencies: {},
Generators: {}, Generators: {},
"Transmission lines": {}, "Transmission lines": {},
"Storage units": {},
"Price-sensitive loads": {},
}; };
test("fixtures", () => {}); test("fixtures", () => {});

@ -20,7 +20,4 @@ export const BLANK_SCENARIO: UnitCommitmentScenario = {
Buses: {}, Buses: {},
Generators: {}, Generators: {},
"Transmission lines": {}, "Transmission lines": {},
"Storage units": {},
"Price-sensitive loads": {},
Contingencies: {},
}; };

@ -45,35 +45,6 @@ export interface TransmissionLine {
"Flow limit penalty ($/MW)": number; "Flow limit penalty ($/MW)": number;
} }
export interface StorageUnit {
Bus: string;
"Minimum level (MWh)": number;
"Maximum level (MWh)": number;
"Charge cost ($/MW)": number;
"Discharge cost ($/MW)": number;
"Charge efficiency": number;
"Discharge efficiency": number;
"Loss factor": number;
"Minimum charge rate (MW)": number;
"Maximum charge rate (MW)": number;
"Minimum discharge rate (MW)": number;
"Maximum discharge rate (MW)": number;
"Initial level (MWh)": number;
"Last period minimum level (MWh)": number;
"Last period maximum level (MWh)": number;
}
export interface PriceSensitiveLoad {
Bus: string;
"Revenue ($/MW)": number;
"Demand (MW)": number[];
}
export interface Contingency {
"Affected lines": string[];
"Affected generators": string[];
}
export interface UnitCommitmentScenario { export interface UnitCommitmentScenario {
Parameters: { Parameters: {
Version: string; Version: string;
@ -86,15 +57,6 @@ export interface UnitCommitmentScenario {
"Transmission lines": { "Transmission lines": {
[name: string]: TransmissionLine; [name: string]: TransmissionLine;
}; };
"Storage units": {
[name: string]: StorageUnit;
};
"Price-sensitive loads": {
[name: string]: PriceSensitiveLoad;
};
Contingencies: {
[name: string]: Contingency;
};
} }
const getTypedGenerators = <T extends any>( const getTypedGenerators = <T extends any>(

@ -253,6 +253,6 @@ export const assertBusesNotEmpty = (
scenario: UnitCommitmentScenario, scenario: UnitCommitmentScenario,
): ValidationError | null => { ): ValidationError | null => {
if (Object.keys(scenario.Buses).length === 0) if (Object.keys(scenario.Buses).length === 0)
return { message: "This component requires an existing bus." }; return { message: "Profiled unit requires an existing bus." };
return null; return null;
}; };

@ -33,7 +33,7 @@ test("createThermalUnit", () => {
test("createProfiledUnit with blank file", () => { test("createProfiledUnit with blank file", () => {
const [, err] = createProfiledUnit(TEST_DATA_BLANK); const [, err] = createProfiledUnit(TEST_DATA_BLANK);
assert(err !== null); assert(err !== null);
assert.equal(err.message, "This component requires an existing bus."); assert.equal(err.message, "Profiled unit requires an existing bus.");
}); });
test("changeProfiledUnitData", () => { test("changeProfiledUnitData", () => {

@ -35,9 +35,6 @@ export const changeTimeHorizon = (
generator["Maximum power (MW)"] = generator["Maximum power (MW)"].slice(0, newT); generator["Maximum power (MW)"] = generator["Maximum power (MW)"].slice(0, newT);
} }
}); });
Object.values(newScenario["Price-sensitive loads"]).forEach((psLoad) => {
psLoad["Demand (MW)"] = psLoad["Demand (MW)"].slice(0, newT);
});
} else { } else {
const padding = Array(newT - oldT).fill(0); const padding = Array(newT - oldT).fill(0);
Object.values(newScenario.Buses).forEach((bus) => { Object.values(newScenario.Buses).forEach((bus) => {
@ -49,9 +46,6 @@ export const changeTimeHorizon = (
generator["Maximum power (MW)"] = generator["Maximum power (MW)"].concat(padding); generator["Maximum power (MW)"] = generator["Maximum power (MW)"].concat(padding);
} }
}); });
Object.values(newScenario["Price-sensitive loads"]).forEach((psLoad) => {
psLoad["Demand (MW)"] = psLoad["Demand (MW)"].concat(padding);
});
} }
return [newScenario, null]; return [newScenario, null];
}; };
@ -162,28 +156,6 @@ export const changeTimeStep = (
} }
} }
const newPriceSensitiveLoads: { [name: string]: any } = {};
for (const psLoadName in scenario["Price-sensitive loads"]) {
const psLoad = scenario["Price-sensitive loads"][psLoadName]!;
// Build data_y for demand
const demand = psLoad["Demand (MW)"];
const demandData_y = Array(oldT + 1).fill(0);
for (let i = 0; i < oldT; i++) demandData_y[i] = demand[i];
demandData_y[oldT] = demandData_y[0];
// Run interpolation for demand
const newDemand = Array(newT).fill(0);
for (let i = 0; i < newT; i++) {
newDemand[i] = evaluatePwlFunction(data_x, demandData_y, newTimeStep * i);
}
newPriceSensitiveLoads[psLoadName] = {
...psLoad,
"Demand (MW)": newDemand,
};
}
return [ return [
{ {
...scenario, ...scenario,
@ -193,7 +165,6 @@ export const changeTimeStep = (
}, },
Buses: newBuses, Buses: newBuses,
Generators: newGenerators, Generators: newGenerators,
"Price-sensitive loads": newPriceSensitiveLoads,
}, },
null, null,
]; ];

@ -20,8 +20,7 @@ export const PREPROCESSING_TEST_DATA_1: any = {
}; };
test("preprocess", () => { test("preprocess", () => {
const [newScenario, err] = preprocess(PREPROCESSING_TEST_DATA_1); const newScenario = preprocess(PREPROCESSING_TEST_DATA_1);
assert(err === null);
assert.deepEqual(newScenario, { assert.deepEqual(newScenario, {
Parameters: { Parameters: {
Version: "0.4", Version: "0.4",
@ -36,11 +35,5 @@ test("preprocess", () => {
b2: { "Load (MW)": [10, 10, 10, 10, 10] }, b2: { "Load (MW)": [10, 10, 10, 10, 10] },
b3: { "Load (MW)": [27.3729, 26.29698, 25.58005, 25.15675, 25.4268] }, b3: { "Load (MW)": [27.3729, 26.29698, 25.58005, 25.15675, 25.4268] },
}, },
"Price-sensitive loads": {},
"Storage units": {},
"Transmission lines": {},
Contingencies: {},
Generators: {},
Reserves: {},
}); });
}); });

@ -7,10 +7,6 @@
import { validate, ValidationError } from "../Data/validate"; import { validate, ValidationError } from "../Data/validate";
import { UnitCommitmentScenario } from "../Data/types"; import { UnitCommitmentScenario } from "../Data/types";
import { migrate } from "../Data/migrate"; import { migrate } from "../Data/migrate";
import {
getContingencyTransmissionLines,
rebuildContingencies,
} from "./transmissionOps";
export const preprocess = ( export const preprocess = (
data: any, data: any,
@ -45,26 +41,6 @@ export const preprocess = (
} }
} }
// Add optional fields
for (let field of [
"Buses",
"Generators",
"Storage units",
"Price-sensitive loads",
"Transmission lines",
"Reserves",
"Contingencies",
]) {
if (!result[field]) {
result[field] = {};
}
}
const scenario = result as unknown as UnitCommitmentScenario; const scenario = result as unknown as UnitCommitmentScenario;
// Rebuild contingencies
const contingencyLines = getContingencyTransmissionLines(scenario);
scenario["Contingencies"] = rebuildContingencies(contingencyLines);
return [scenario, null]; return [scenario, null];
}; };

@ -1,60 +0,0 @@
/*
* UnitCommitment.jl: Optimization Package for Security-Constrained Unit Commitment
* Copyright (C) 2020-2025, UChicago Argonne, LLC. All rights reserved.
* Released under the modified BSD license. See COPYING.md for more details.
*/
import { TEST_DATA_1 } from "../Data/fixtures.test";
import assert from "node:assert";
import {
changePriceSensitiveLoadData,
createPriceSensitiveLoad,
deletePriceSensitiveLoad,
renamePriceSensitiveLoad,
} from "./psloadOps";
import { ValidationError } from "../Data/validate";
test("createPriceSensitiveLoad", () => {
const [newScenario, err] = createPriceSensitiveLoad(TEST_DATA_1);
assert(err === null);
assert.equal(Object.keys(newScenario["Price-sensitive loads"]).length, 2);
assert("ps2" in newScenario["Price-sensitive loads"]);
});
test("renamePriceSensitiveLoad", () => {
const [newScenario, err] = renamePriceSensitiveLoad(
"ps1",
"ps2",
TEST_DATA_1,
);
assert(err === null);
assert.deepEqual(
newScenario["Price-sensitive loads"]["ps2"],
TEST_DATA_1["Price-sensitive loads"]["ps1"],
);
assert.equal(Object.keys(newScenario["Price-sensitive loads"]).length, 1);
});
test("changePriceSensitiveLoadData", () => {
let scenario = TEST_DATA_1;
let err: ValidationError | null;
[scenario, err] = changePriceSensitiveLoadData("ps1", "Bus", "b3", scenario);
assert.equal(err, null);
[scenario, err] = changePriceSensitiveLoadData(
"ps1",
"Demand (MW) 00:00",
"99",
scenario,
);
assert.equal(err, null);
assert.deepEqual(scenario["Price-sensitive loads"]["ps1"], {
Bus: "b3",
"Revenue ($/MW)": 23,
"Demand (MW)": [99, 50, 50, 50, 50],
});
});
test("deletePriceSensitiveLoad", () => {
const newScenario = deletePriceSensitiveLoad("ps1", TEST_DATA_1);
assert.equal(Object.keys(newScenario["Price-sensitive loads"]).length, 0);
});

@ -1,88 +0,0 @@
/*
* UnitCommitment.jl: Optimization Package for Security-Constrained Unit Commitment
* Copyright (C) 2020-2025, UChicago Argonne, LLC. All rights reserved.
* Released under the modified BSD license. See COPYING.md for more details.
*/
import { ValidationError } from "../Data/validate";
import { PriceSensitiveLoad, UnitCommitmentScenario } from "../Data/types";
import {
assertBusesNotEmpty,
changeData,
generateUniqueName,
renameItemInObject,
} from "./commonOps";
import { PriceSensitiveLoadsColumnSpec } from "../../components/CaseBuilder/Psload";
import { generateTimeslots } from "../../components/Common/Forms/DataTable";
export const createPriceSensitiveLoad = (
scenario: UnitCommitmentScenario,
): [UnitCommitmentScenario, ValidationError | null] => {
const err = assertBusesNotEmpty(scenario);
if (err) return [scenario, err];
const busName = Object.keys(scenario.Buses)[0]!;
const timeslots = generateTimeslots(scenario);
const name = generateUniqueName(scenario["Price-sensitive loads"], "ps");
return [
{
...scenario,
"Price-sensitive loads": {
...scenario["Price-sensitive loads"],
[name]: {
Bus: busName,
"Revenue ($/MW)": 0,
"Demand (MW)": Array(timeslots.length).fill(0),
},
},
},
null,
];
};
export const renamePriceSensitiveLoad = (
oldName: string,
newName: string,
scenario: UnitCommitmentScenario,
): [UnitCommitmentScenario, ValidationError | null] => {
const [newObj, err] = renameItemInObject(
oldName,
newName,
scenario["Price-sensitive loads"],
);
if (err) return [scenario, err];
return [{ ...scenario, "Price-sensitive loads": newObj }, null];
};
export const changePriceSensitiveLoadData = (
name: string,
field: string,
newValueStr: string,
scenario: UnitCommitmentScenario,
): [UnitCommitmentScenario, ValidationError | null] => {
const [newObj, err] = changeData(
field,
newValueStr,
scenario["Price-sensitive loads"][name]!,
PriceSensitiveLoadsColumnSpec,
scenario,
);
if (err) return [scenario, err];
return [
{
...scenario,
"Price-sensitive loads": {
...scenario["Price-sensitive loads"],
[name]: newObj as PriceSensitiveLoad,
},
},
null,
];
};
export const deletePriceSensitiveLoad = (
name: string,
scenario: UnitCommitmentScenario,
): UnitCommitmentScenario => {
const { [name]: _, ...newContainer } = scenario["Price-sensitive loads"];
return { ...scenario, "Price-sensitive loads": newContainer };
};

@ -1,75 +0,0 @@
/*
* UnitCommitment.jl: Optimization Package for Security-Constrained Unit Commitment
* Copyright (C) 2020-2025, UChicago Argonne, LLC. All rights reserved.
* Released under the modified BSD license. See COPYING.md for more details.
*/
import { TEST_DATA_1 } from "../Data/fixtures.test";
import assert from "node:assert";
import {
changeStorageUnitData,
createStorageUnit,
deleteStorageUnit,
renameStorageUnit,
} from "./storageOps";
import { ValidationError } from "../Data/validate";
test("createStorageUnit", () => {
const [newScenario, err] = createStorageUnit(TEST_DATA_1);
assert(err === null);
assert.equal(Object.keys(newScenario["Storage units"]).length, 2);
assert("su2" in newScenario["Storage units"]);
});
test("renameStorageUnit", () => {
const [newScenario, err] = renameStorageUnit("su1", "su2", TEST_DATA_1);
assert(err === null);
assert.deepEqual(
newScenario["Storage units"]["su2"],
TEST_DATA_1["Storage units"]["su1"],
);
assert.equal(Object.keys(newScenario["Storage units"]).length, 1);
});
test("changeStorageUnitData", () => {
let scenario = TEST_DATA_1;
let err: ValidationError | null;
[scenario, err] = changeStorageUnitData("su1", "Bus", "b3", scenario);
assert.equal(err, null);
[scenario, err] = changeStorageUnitData(
"su1",
"Minimum level (MWh)",
"99",
scenario,
);
assert.equal(err, null);
[scenario, err] = changeStorageUnitData(
"su1",
"Maximum discharge rate (MW)",
"99",
scenario,
);
assert.equal(err, null);
assert.deepEqual(scenario["Storage units"]["su1"], {
Bus: "b3",
"Minimum level (MWh)": 99.0,
"Maximum level (MWh)": 100.0,
"Charge cost ($/MW)": 2.0,
"Discharge cost ($/MW)": 1.0,
"Charge efficiency": 0.8,
"Discharge efficiency": 0.85,
"Loss factor": 0.01,
"Minimum charge rate (MW)": 5.0,
"Maximum charge rate (MW)": 10.0,
"Minimum discharge rate (MW)": 4.0,
"Maximum discharge rate (MW)": 99.0,
"Initial level (MWh)": 20.0,
"Last period minimum level (MWh)": 21.0,
"Last period maximum level (MWh)": 22.0,
});
});
test("deleteStorageUnit", () => {
const newScenario = deleteStorageUnit("su1", TEST_DATA_1);
assert.equal(Object.keys(newScenario["Storage units"]).length, 0);
});

@ -1,98 +0,0 @@
/*
* UnitCommitment.jl: Optimization Package for Security-Constrained Unit Commitment
* Copyright (C) 2020-2025, UChicago Argonne, LLC. All rights reserved.
* Released under the modified BSD license. See COPYING.md for more details.
*/
import { ValidationError } from "../Data/validate";
import { StorageUnit, UnitCommitmentScenario } from "../Data/types";
import {
assertBusesNotEmpty,
changeData,
generateUniqueName,
renameItemInObject,
} from "./commonOps";
import { StorageUnitsColumnSpec } from "../../components/CaseBuilder/StorageUnits";
export const createStorageUnit = (
scenario: UnitCommitmentScenario,
): [UnitCommitmentScenario, ValidationError | null] => {
const err = assertBusesNotEmpty(scenario);
if (err) return [scenario, err];
const busName = Object.keys(scenario.Buses)[0]!;
const name = generateUniqueName(scenario["Storage units"], "su");
return [
{
...scenario,
"Storage units": {
...scenario["Storage units"],
[name]: {
Bus: busName,
"Minimum level (MWh)": 0,
"Maximum level (MWh)": 1,
"Charge cost ($/MW)": 0.0,
"Discharge cost ($/MW)": 0.0,
"Charge efficiency": 1,
"Discharge efficiency": 1,
"Loss factor": 0,
"Minimum charge rate (MW)": 1,
"Maximum charge rate (MW)": 1,
"Minimum discharge rate (MW)": 1,
"Maximum discharge rate (MW)": 1,
"Initial level (MWh)": 0,
"Last period minimum level (MWh)": 0,
"Last period maximum level (MWh)": 1,
},
},
},
null,
];
};
export const renameStorageUnit = (
oldName: string,
newName: string,
scenario: UnitCommitmentScenario,
): [UnitCommitmentScenario, ValidationError | null] => {
const [newObj, err] = renameItemInObject(
oldName,
newName,
scenario["Storage units"],
);
if (err) return [scenario, err];
return [{ ...scenario, "Storage units": newObj }, null];
};
export const changeStorageUnitData = (
name: string,
field: string,
newValueStr: string,
scenario: UnitCommitmentScenario,
): [UnitCommitmentScenario, ValidationError | null] => {
const [newObj, err] = changeData(
field,
newValueStr,
scenario["Storage units"][name]!,
StorageUnitsColumnSpec,
scenario,
);
if (err) return [scenario, err];
return [
{
...scenario,
"Storage units": {
...scenario["Storage units"],
[name]: newObj as StorageUnit,
},
},
null,
];
};
export const deleteStorageUnit = (
name: string,
scenario: UnitCommitmentScenario,
): UnitCommitmentScenario => {
const { [name]: _, ...newContainer } = scenario["Storage units"];
return { ...scenario, "Storage units": newContainer };
};

@ -10,8 +10,6 @@ import {
changeTransmissionLineData, changeTransmissionLineData,
createTransmissionLine, createTransmissionLine,
deleteTransmissionLine, deleteTransmissionLine,
getContingencyTransmissionLines,
rebuildContingencies,
renameTransmissionLine, renameTransmissionLine,
} from "./transmissionOps"; } from "./transmissionOps";
import { ValidationError } from "../Data/validate"; import { ValidationError } from "../Data/validate";
@ -34,12 +32,6 @@ test("renameTransmissionLine", () => {
"Emergency flow limit (MW)": 20000.0, "Emergency flow limit (MW)": 20000.0,
"Flow limit penalty ($/MW)": 5000.0, "Flow limit penalty ($/MW)": 5000.0,
}); });
assert.deepEqual(newScenario["Contingencies"], {
l3: {
"Affected lines": ["l3"],
"Affected generators": [],
},
});
assert.equal(Object.keys(newScenario["Transmission lines"]).length, 1); assert.equal(Object.keys(newScenario["Transmission lines"]).length, 1);
}); });
@ -80,23 +72,4 @@ test("changeTransmissionLineData", () => {
test("deleteTransmissionLine", () => { test("deleteTransmissionLine", () => {
const newScenario = deleteTransmissionLine("l1", TEST_DATA_1); const newScenario = deleteTransmissionLine("l1", TEST_DATA_1);
assert.equal(Object.keys(newScenario["Transmission lines"]).length, 0); assert.equal(Object.keys(newScenario["Transmission lines"]).length, 0);
assert.equal(Object.keys(newScenario["Contingencies"]).length, 0);
});
test("getContingencyTransmissionLines", () => {
const contLines = getContingencyTransmissionLines(TEST_DATA_1);
assert.deepEqual(contLines, new Set(["l1"]));
});
test("rebuildContingencies", () => {
assert.deepEqual(rebuildContingencies(new Set(["l1", "l2"])), {
l1: {
"Affected lines": ["l1"],
"Affected generators": [],
},
l2: {
"Affected lines": ["l2"],
"Affected generators": [],
},
});
}); });

@ -8,16 +8,11 @@ import {
assertBusesNotEmpty, assertBusesNotEmpty,
changeData, changeData,
generateUniqueName, generateUniqueName,
parseBool,
renameItemInObject, renameItemInObject,
} from "./commonOps"; } from "./commonOps";
import { ValidationError } from "../Data/validate"; import { ValidationError } from "../Data/validate";
import { TransmissionLinesColumnSpec } from "../../components/CaseBuilder/TransmissionLines"; import { TransmissionLinesColumnSpec } from "../../components/CaseBuilder/TransmissionLines";
import { import { TransmissionLine, UnitCommitmentScenario } from "../Data/types";
Contingency,
TransmissionLine,
UnitCommitmentScenario,
} from "../Data/types";
export const createTransmissionLine = ( export const createTransmissionLine = (
scenario: UnitCommitmentScenario, scenario: UnitCommitmentScenario,
@ -56,24 +51,7 @@ export const renameTransmissionLine = (
scenario["Transmission lines"], scenario["Transmission lines"],
); );
if (err) return [scenario, err]; if (err) return [scenario, err];
return [{ ...scenario, "Transmission lines": newLine }, null];
// Update transmission line contingencies
let newContingencies = scenario["Contingencies"];
const contingencyLines = getContingencyTransmissionLines(scenario);
if (contingencyLines.has(oldName)) {
contingencyLines.delete(oldName);
contingencyLines.add(newName);
newContingencies = rebuildContingencies(contingencyLines);
}
return [
{
...scenario,
"Transmission lines": newLine,
Contingencies: newContingencies,
},
null,
];
}; };
export const changeTransmissionLineData = ( export const changeTransmissionLineData = (
@ -82,38 +60,24 @@ export const changeTransmissionLineData = (
newValueStr: string, newValueStr: string,
scenario: UnitCommitmentScenario, scenario: UnitCommitmentScenario,
): [UnitCommitmentScenario, ValidationError | null] => { ): [UnitCommitmentScenario, ValidationError | null] => {
if (field === "Contingency?") { const [newLine, err] = changeData(
// Parse boolean value field,
const [newValue, err] = parseBool(newValueStr); newValueStr,
if (err) return [scenario, err]; scenario["Transmission lines"][line]!,
TransmissionLinesColumnSpec,
// Rebuild contingencies scenario,
const contLines = getContingencyTransmissionLines(scenario); );
if (newValue) contLines.add(line); if (err) return [scenario, err];
else contLines.delete(line); return [
const newContingencies = rebuildContingencies(contLines); {
...scenario,
return [{ ...scenario, Contingencies: newContingencies }, null]; "Transmission lines": {
} else { ...scenario["Transmission lines"],
const [newLine, err] = changeData( [line]: newLine as TransmissionLine,
field,
newValueStr,
scenario["Transmission lines"][line]!,
TransmissionLinesColumnSpec,
scenario,
);
if (err) return [scenario, err];
return [
{
...scenario,
"Transmission lines": {
...scenario["Transmission lines"],
[line]: newLine as TransmissionLine,
},
}, },
null, },
]; null,
} ];
}; };
export const deleteTransmissionLine = ( export const deleteTransmissionLine = (
@ -121,43 +85,5 @@ export const deleteTransmissionLine = (
scenario: UnitCommitmentScenario, scenario: UnitCommitmentScenario,
): UnitCommitmentScenario => { ): UnitCommitmentScenario => {
const { [name]: _, ...newLines } = scenario["Transmission lines"]; const { [name]: _, ...newLines } = scenario["Transmission lines"];
return { ...scenario, "Transmission lines": newLines };
// Update transmission line contingencies
let newContingencies = scenario["Contingencies"];
const contingencyLines = getContingencyTransmissionLines(scenario);
if (contingencyLines.has(name)) {
contingencyLines.delete(name);
newContingencies = rebuildContingencies(contingencyLines);
}
return {
...scenario,
"Transmission lines": newLines,
Contingencies: newContingencies,
};
};
export const getContingencyTransmissionLines = (
scenario: UnitCommitmentScenario,
): Set<String> => {
let result: Set<String> = new Set();
Object.entries(scenario.Contingencies).forEach(([name, contingency]) => {
if (contingency["Affected lines"].length !== 1)
throw Error("not implemented");
result.add(contingency["Affected lines"][0]!!);
});
return result;
};
export const rebuildContingencies = (
contingencyLines: Set<String>,
): { [name: string]: Contingency } => {
const result: { [name: string]: Contingency } = {};
contingencyLines.forEach((lineName) => {
result[lineName as string] = {
"Affected lines": [lineName as string],
"Affected generators": [],
};
});
return result;
}; };

Loading…
Cancel
Save