web: Profiled units

web/src/components/CaseBuilder/Buses/Buses.tsx

@@ -0,0 +1,115 @@
+/*
+ * 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 SectionHeader from "../../Common/SectionHeader/SectionHeader";
+import SectionButton from "../../Common/Buttons/SectionButton";
+import {
+  faDownload,
+  faPlus,
+  faUpload,
+} from "@fortawesome/free-solid-svg-icons";
+import { offerDownload } from "../../Common/io";
+import FileUploadElement from "../../Common/Buttons/FileUploadElement";
+import { useRef } from "react";
+import { ValidationError } from "../../../core/Validation/validate";
+import DataTable, {
+  addNameColumn,
+  addTimeseriesColumn,
+  ColumnSpec,
+  generateCsv,
+  generateTableColumns,
+  generateTableData,
+} from "../../Common/Forms/DataTable";
+
+import { UnitCommitmentScenario } from "../../../core/fixtures";
+import { ColumnDefinition } from "tabulator-tables";
+import { parseBusesCsv } from "./BusesCsv";
+
+export const generateBusesData = (
+  scenario: UnitCommitmentScenario,
+): [any[], ColumnDefinition[]] => {
+  const colSpecs: ColumnSpec[] = [
+    {
+      title: "Name",
+      type: "string",
+      width: 150,
+    },
+    {
+      title: "Load (MW)",
+      type: "number[]",
+      width: 60,
+    },
+  ];
+  const columns = generateTableColumns(scenario, colSpecs);
+  const data = generateTableData(scenario.Buses, colSpecs, scenario);
+  return [data, columns];
+};
+
+export const generateBusesColumns = (
+  scenario: UnitCommitmentScenario,
+): ColumnDefinition[] => {
+  const columns: ColumnDefinition[] = [];
+  addNameColumn(columns);
+  addTimeseriesColumn(scenario, "Load (MW)", columns);
+  return columns;
+};
+
+interface BusesProps {
+  scenario: UnitCommitmentScenario;
+  onBusCreated: () => void;
+  onBusDataChanged: (
+    bus: string,
+    field: string,
+    newValue: string,
+  ) => ValidationError | null;
+  onBusDeleted: (bus: string) => ValidationError | null;
+  onBusRenamed: (oldName: string, newName: string) => ValidationError | null;
+  onDataChanged: (scenario: UnitCommitmentScenario) => void;
+}
+
+function BusesComponent(props: BusesProps) {
+  const fileUploadElem = useRef<FileUploadElement>(null);
+
+  const onDownload = () => {
+    const [data, columns] = generateBusesData(props.scenario);
+    const csvContents = generateCsv(data, columns);
+    offerDownload(csvContents, "text/csv", "buses.csv");
+  };
+
+  const onUpload = () => {
+    fileUploadElem.current!.showFilePicker((csvContents: any) => {
+      const newScenario = parseBusesCsv(props.scenario, csvContents);
+      props.onDataChanged(newScenario);
+    });
+  };
+
+  return (
+    <div>
+      <SectionHeader title="Buses">
+        <SectionButton
+          icon={faPlus}
+          tooltip="Add"
+          onClick={props.onBusCreated}
+        />
+        <SectionButton
+          icon={faDownload}
+          tooltip="Download"
+          onClick={onDownload}
+        />
+        <SectionButton icon={faUpload} tooltip="Upload" onClick={onUpload} />
+      </SectionHeader>
+      <DataTable
+        onRowDeleted={props.onBusDeleted}
+        onRowRenamed={props.onBusRenamed}
+        onDataChanged={props.onBusDataChanged}
+        generateData={() => generateBusesData(props.scenario)}
+      />
+      <FileUploadElement ref={fileUploadElem} accept=".csv" />
+    </div>
+  );
+}
+
+export default BusesComponent;

web/src/components/CaseBuilder/Buses/BusesCsv.ts

@@ -0,0 +1,64 @@
+/*
+ * 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 { Buses, UnitCommitmentScenario } from "../../../core/fixtures";
+import Papa from "papaparse";
+import { generateBusesColumns } from "./Buses";
+
+export const parseBusesCsv = (
+  scenario: UnitCommitmentScenario,
+  csvData: string,
+): UnitCommitmentScenario => {
+  const results = Papa.parse(csvData, {
+    header: true,
+    skipEmptyLines: true,
+    transformHeader: (header) => header.trim(),
+    transform: (value) => value.trim(),
+  });
+
+  // Check for parsing errors
+  if (results.errors.length > 0) {
+    throw Error(`Invalid CSV: Parsing error: ${results.errors}`);
+  }
+
+  // Check CSV headers
+  const expectedFields = generateBusesColumns(scenario).map(
+    (col) => col.field,
+  )!;
+  const actualFields = results.meta.fields!;
+  for (let i = 0; i < expectedFields.length; i++) {
+    if (expectedFields[i] !== actualFields[i]) {
+      throw Error(`Invalid CSV: Header mismatch at column ${i + 1}"`);
+    }
+  }
+
+  // Parse each row
+  const T = getNumTimesteps(scenario);
+  const buses: Buses = {};
+  for (let i = 0; i < results.data.length; i++) {
+    const row = results.data[i] as { [key: string]: any };
+    const busName = row["Name"] as string;
+    const busLoad: number[] = Array(T);
+    for (let j = 0; j < T; j++) {
+      busLoad[j] = parseFloat(row[`Load ${j}`]);
+    }
+    buses[busName] = {
+      "Load (MW)": busLoad,
+    };
+  }
+  return {
+    ...scenario,
+    Buses: buses,
+  };
+};
+
+function getNumTimesteps(scenario: UnitCommitmentScenario) {
+  return (
+    (scenario.Parameters["Time horizon (h)"] *
+      scenario.Parameters["Time step (min)"]) /
+    60
+  );
+}