@nfdi4plants/arctrl 3.1.1 → 3.2.0

package/dist/ts/ts/Core/Table/ArcTable.js

@@ -1,26 +1,26 @@
-import { getEnumerator, disposeSafe, comparePrimitives, equals, safeHash } from '../../../node_modules/@fable-org/fable-library-js/Util.js';
+import { getEnumerator, disposeSafe, Exception, comparePrimitives, equals, safeHash } from '../../../node_modules/@fable-org/fable-library-ts/Util.js';
 import { CompositeCell, CompositeCell_Term, CompositeCell_FreeText } from './CompositeCell.js';
 import { SanityChecks_validateCellColumns, ArcTableValues, SanityChecks_validateArcTableValues, Unchecked_tryGetCellAt, SanityChecks_validateColumnIndex, SanityChecks_validateRowIndex, Unchecked_getCellWithDefault, Unchecked_setCellAt, tryFindDuplicateUnique, SanityChecks_validateColumn, Unchecked_addColumn, Unchecked_addColumnFill, Unchecked_removeHeader, Unchecked_removeColumnCells, tryFindDuplicateUniqueInArray, Unchecked_removeColumnCells_withIndexChange, getEmptyCellForHeader, Unchecked_moveColumnTo, Unchecked_addRow, Unchecked_addEmptyRow, Unchecked_addRows, Unchecked_removeRowCells_withIndexChange, Unchecked_alignByHeaders } from './ArcTableAux.js';
-import { CompositeHeader_ProtocolType, CompositeHeader_ProtocolVersion, CompositeHeader_ProtocolUri, CompositeHeader_ProtocolDescription, CompositeHeader_ProtocolREF } from './CompositeHeader.js';
-import { defaultArg, unwrap, value, map as map$1 } from '../../../node_modules/@fable-org/fable-library-js/Option.js';
-import { toArray, delay, map, removeAt, iterate as iterate$1, tryFindIndex, length, collect, singleton, choose, indexed, toList, mapIndexed, append as append$1 } from '../../../node_modules/@fable-org/fable-library-js/Seq.js';
+import { CompositeHeader } from './CompositeHeader.js';
+import { defaultArg, unwrap, value } from '../../../node_modules/@fable-org/fable-library-ts/Option.js';
+import { toArray, delay, map, removeAt, iterate as iterate$1, tryFindIndex, length, collect, singleton, choose, indexed, toList, mapIndexed, append as append$1 } from '../../../node_modules/@fable-org/fable-library-ts/Seq.js';
 import { CompositeColumn } from './CompositeColumn.js';
-import { rangeDouble } from '../../../node_modules/@fable-org/fable-library-js/Range.js';
+import { rangeDouble } from '../../../node_modules/@fable-org/fable-library-ts/Range.js';
 import { ResizeArray_map, ResizeArray_iteri, ResizeArray_singleton, ResizeArray_iter, ResizeArray_init, ResizeArray_choose, ResizeArray_mapi, ResizeArray_groupBy, ResizeArray_indexed } from '../Helper/Collections.js';
-import { isEmpty, iterate, append } from '../../../node_modules/@fable-org/fable-library-js/List.js';
-import { StringBuilder_$ctor, StringBuilder__AppendLine_Z721C83C5 } from '../../../node_modules/@fable-org/fable-library-js/System.Text.js';
-import { toString } from '../../../node_modules/@fable-org/fable-library-js/Types.js';
-import { sortDescending } from '../../../node_modules/@fable-org/fable-library-js/Array.js';
-import { getItemFromDict } from '../../../node_modules/@fable-org/fable-library-js/MapUtil.js';
-import { toFail, printf, join } from '../../../node_modules/@fable-org/fable-library-js/String.js';
+import { item, setItem, sortDescending } from '../../../node_modules/@fable-org/fable-library-ts/Array.js';
+import { isEmpty, iterate, append } from '../../../node_modules/@fable-org/fable-library-ts/List.js';
+import { StringBuilder_$ctor, StringBuilder__AppendLine_Z721C83C5 } from '../../../node_modules/@fable-org/fable-library-ts/System.Text.js';
+import { toString } from '../../../node_modules/@fable-org/fable-library-ts/Types.js';
+import { getItemFromDict } from '../../../node_modules/@fable-org/fable-library-ts/MapUtil.js';
+import { toFail, printf, join, concat } from '../../../node_modules/@fable-org/fable-library-ts/String.js';
 import { boxHashArray, boxHashSeq } from '../Helper/HashCodes.js';
-import { class_type } from '../../../node_modules/@fable-org/fable-library-js/Reflection.js';
+import { class_type } from '../../../node_modules/@fable-org/fable-library-ts/Reflection.js';
 
 class ArcTable {
   constructor(name, headers, columns) {
     const headers_1 = defaultArg(headers, []);
     const columns_1 = defaultArg(columns, []);
-    const valid = SanityChecks_validateCellColumns(headers_1, columns_1, true);
+    SanityChecks_validateCellColumns(headers_1, columns_1, true);
     this._values = ArcTableValues.fromCellColumns(columns_1);
     this._name = name;
     this._headers = headers_1;
@@ -65,6 +65,9 @@ class ArcTable {
   static create(name, headers, values) {
     return new ArcTable(name, headers, values);
   }
+  /**
+   * Create ArcTable with empty 'ValueHeader' and 'Values'
+   */
   static init(name) {
     return new ArcTable(name, [], []);
   }
@@ -81,11 +84,21 @@ class ArcTable {
     t.AddRows(rows);
     return t;
   }
+  /**
+   * Will return true or false if table is valid.
+   * 
+   * Set `raiseException` = `true` to raise exception.
+   */
   Validate(raiseException) {
     const this$ = this;
     const raiseException_1 = defaultArg(raiseException, true);
     return SanityChecks_validateArcTableValues(this$.Headers, this$.Values, raiseException_1);
   }
+  /**
+   * Will return true or false if table is valid.
+   * 
+   * Set `raiseException` = `true` to raise exception.
+   */
   static validate(raiseException) {
     return (table) => table.Validate(unwrap(raiseException));
   }
@@ -94,7 +107,7 @@ class ArcTable {
     return this$.Headers.length | 0;
   }
   static columnCount(table) {
-    return table.ColumnCount;
+    return table.ColumnCount | 0;
   }
   get RowCount() {
     const this$ = this;
@@ -105,7 +118,7 @@ class ArcTable {
     this$._values.RowCount = newRowCount | 0;
   }
   static rowCount(table) {
-    return table.RowCount;
+    return table.RowCount | 0;
   }
   static setRowCount(newRowCount) {
     return (table) => {
@@ -124,6 +137,9 @@ class ArcTable {
     const nextValues = this$._values.Copy();
     return ArcTable.fromArcTableValues(this$.Name, nextHeaders, nextValues);
   }
+  /**
+   * Returns a cell at given position if it exists, else returns None.
+   */
   TryGetCellAt(column, row) {
     const this$ = this;
     return Unchecked_tryGetCellAt(column, row, this$._values);
@@ -166,15 +182,21 @@ class ArcTable {
       return copy;
     };
   }
+  /**
+   * Update an already existing cell in the table. Fails if cell is outside the column AND row bounds of the table
+   */
   UpdateCellAt(columnIndex, rowIndex, c, skipValidation) {
     const this$ = this;
     if (!defaultArg(skipValidation, false)) {
       SanityChecks_validateColumnIndex(columnIndex, this$.ColumnCount, false);
       SanityChecks_validateRowIndex(rowIndex, this$.RowCount, false);
-      c.ValidateAgainstHeader(this$.Headers[columnIndex], true);
+      c.ValidateAgainstHeader(item(columnIndex, this$.Headers), true);
     }
     Unchecked_setCellAt(columnIndex, rowIndex, c, this$._values);
   }
+  /**
+   * Update an already existing cell in the table. Fails if cell is outside the columnd AND row bounds of the table
+   */
   static updateCellAt(columnIndex, rowIndex, cell, skipValidation) {
     return (table) => {
       const newTable = table.Copy();
@@ -182,14 +204,20 @@ class ArcTable {
       return newTable;
     };
   }
+  /**
+   * Update an already existing cell in the table, or adds a new cell if the row boundary is exceeded. Fails if cell is outside the column bounds of the table
+   */
   SetCellAt(columnIndex, rowIndex, c, skipValidation) {
     const this$ = this;
     if (!defaultArg(skipValidation, false)) {
       SanityChecks_validateColumnIndex(columnIndex, this$.ColumnCount, false);
-      c.ValidateAgainstHeader(this$.Headers[columnIndex], true);
+      c.ValidateAgainstHeader(item(columnIndex, this$.Headers), true);
     }
     Unchecked_setCellAt(columnIndex, rowIndex, c, this$._values);
   }
+  /**
+   * Update an already existing cell in the table, or adds a new cell if the row boundary is exceeded. Fails if cell is outside the column bounds of the table
+   */
   static setCellAt(columnIndex, rowIndex, cell, skipValidation) {
     return (table) => {
       const newTable = table.Copy();
@@ -197,6 +225,11 @@ class ArcTable {
       return newTable;
     };
   }
+  /**
+   * Update cells in a column by a function.
+   * 
+   * Inputs of the function are columnIndex, rowIndex, and the current cell.
+   */
   UpdateCellsBy(f, skipValidation) {
     const this$ = this;
     const skipValidation_1 = defaultArg(skipValidation, false);
@@ -209,7 +242,7 @@ class ArcTable {
         const ci = patternInput[0] | 0;
         const newCell = f(ci, ri, kv[1]);
         if (!skipValidation_1) {
-          newCell.ValidateAgainstHeader(this$.Headers[ci], true);
+          newCell.ValidateAgainstHeader(item(ci, this$.Headers), true);
         }
         Unchecked_setCellAt(ci, ri, newCell, this$._values);
       }
@@ -217,12 +250,22 @@ class ArcTable {
       disposeSafe(enumerator);
     }
   }
+  /**
+   * Update cells in a column by a function.
+   * 
+   * Inputs of the function are columnIndex, rowIndex, and the current cell.static member updateCellBy(f : int -> int -> CompositeCell -> CompositeCell) =
+   */
   static updateCellsBy(f, skipValidation) {
     return (table) => {
       const newTable = table.Copy();
       newTable.UpdateCellsBy(f, unwrap(skipValidation));
     };
   }
+  /**
+   * Update cells in a column by a function.
+   * 
+   * Inputs of the function are columnIndex, rowIndex, and the current cell.
+   */
   UpdateCellBy(columnIndex, rowIndex, f, skipValidation) {
     const this$ = this;
     const skipValidation_1 = defaultArg(skipValidation, false);
@@ -232,10 +275,15 @@ class ArcTable {
     }
     const newCell = f(this$.GetCellAt(columnIndex, rowIndex));
     if (!skipValidation_1) {
-      newCell.ValidateAgainstHeader(this$.Headers[columnIndex], true);
+      newCell.ValidateAgainstHeader(item(columnIndex, this$.Headers), true);
     }
     Unchecked_setCellAt(columnIndex, rowIndex, newCell, this$._values);
   }
+  /**
+   * Update cells in a column by a function.
+   * 
+   * Inputs of the function are columnIndex, rowIndex, and the current cell.static member updateCellBy(f : int -> int -> CompositeCell -> CompositeCell) =
+   */
   static updateCellBy(columnIndex, rowIndex, f, skipValidation) {
     return (table) => {
       const newTable = table.Copy();
@@ -249,12 +297,11 @@ class ArcTable {
     const header = newHeader;
     const matchValue = tryFindDuplicateUnique(header, removeAt(index, this$.Headers));
     if (matchValue != null) {
-      throw new Error(`Invalid input. Tried setting unique header \`${header}\`, but header of same type already exists at index ${value(matchValue)}.`);
+      throw new Exception(`Invalid input. Tried setting unique header \`${header}\`, but header of same type already exists at index ${value(matchValue)}.`);
     }
     const c = new CompositeColumn(newHeader, this$.GetColumn(index).Cells);
     if (c.Validate()) {
-      let setHeader;
-      setHeader = this$.Headers[index] = newHeader;
+      setItem(this$.Headers, index, newHeader);
     } else if (forceConvertCells_1) {
       const convertedCells = newHeader.IsTermColumn ? ResizeArray_map((c_1) => {
         if (c_1.isFreeText) {
@@ -265,7 +312,7 @@ class ArcTable {
       }, c.Cells) : ResizeArray_map((c_2) => c_2.ToFreeTextCell(), c.Cells);
       this$.UpdateColumn(index, newHeader, convertedCells);
     } else {
-      throw new Error("Tried setting header for column with invalid type of cells. Set `forceConvertCells` flag to automatically convert cells into valid CompositeCell type.");
+      throw new Exception("Tried setting header for column with invalid type of cells. Set `forceConvertCells` flag to automatically convert cells into valid CompositeCell type.");
     }
   }
   static updateHeader(index, header) {
@@ -291,6 +338,9 @@ class ArcTable {
       return newTable;
     };
   }
+  /**
+   * Adds a new column which fills in the single given value for the length of the table.
+   */
   AddColumnFill(header, cell, index, forceReplace) {
     const this$ = this;
     const index_1 = defaultArg(index, this$.ColumnCount) | 0;
@@ -306,6 +356,9 @@ class ArcTable {
       return newTable;
     };
   }
+  /**
+   * Replaces the header and cells of a column at given index.
+   */
   UpdateColumn(columnIndex, header, cells) {
     const this$ = this;
     SanityChecks_validateColumnIndex(columnIndex, this$.ColumnCount, false);
@@ -314,7 +367,7 @@ class ArcTable {
     const header_1 = column.Header;
     const matchValue = tryFindDuplicateUnique(header_1, removeAt(columnIndex, this$.Headers));
     if (matchValue != null) {
-      throw new Error(`Invalid input. Tried setting unique header \`${header_1}\`, but header of same type already exists at index ${value(matchValue)}.`);
+      throw new Exception(`Invalid input. Tried setting unique header \`${header_1}\`, but header of same type already exists at index ${value(matchValue)}.`);
     }
     Unchecked_removeHeader(columnIndex, this$.Headers);
     Unchecked_removeColumnCells(columnIndex, this$._values);
@@ -323,6 +376,9 @@ class ArcTable {
       Unchecked_setCellAt(columnIndex, rowIndex, v, this$._values);
     }, column.Cells);
   }
+  /**
+   * Replaces the header and cells of a column at given index.
+   */
   static updateColumn(columnIndex, header, cells) {
     return (table) => {
       const newTable = table.Copy();
@@ -364,7 +420,7 @@ class ArcTable {
       iterate((x_1) => {
         StringBuilder__AppendLine_Z721C83C5(sb, `Duplicate \`${x_1.HeaderType}\` at index ${x_1.Index1} and ${x_1.Index2}.`);
       }, duplicates);
-      throw new Error(toString(sb));
+      throw new Exception(toString(sb));
     }
     iterate$1((x_2) => {
       SanityChecks_validateColumn(x_2);
@@ -404,7 +460,7 @@ class ArcTable {
       SanityChecks_validateColumnIndex(index, this$.ColumnCount, false);
     });
     const indexArr_1 = sortDescending(indexArr, {
-      Compare: comparePrimitives
+      Compare: (x, y) => comparePrimitives(x, y) | 0
     });
     indexArr_1.forEach((index_1) => {
       this$.RemoveColumn(index_1);
@@ -417,11 +473,14 @@ class ArcTable {
       return newTable;
     };
   }
+  /**
+   * Return a CompositeColumn for the given column index. Fills the column with empty cells for rows that do not have a value.
+   */
   GetColumn(columnIndex, failOnMissingCell) {
     const this$ = this;
     const failOnMissingCell_1 = defaultArg(failOnMissingCell, false);
     SanityChecks_validateColumnIndex(columnIndex, this$.ColumnCount, false);
-    const h = this$.Headers[columnIndex];
+    const h = item(columnIndex, this$.Headers);
     const cells = [];
     if (this$.RowCount !== 0) {
       const col = getItemFromDict(this$._values.Columns, columnIndex);
@@ -448,23 +507,49 @@ class ArcTable {
     }
     return CompositeColumn.create(h, cells);
   }
+  /**
+   * Return a CompositeColumn for the given column index. Fills the column with empty cells for rows that do not have a value.
+   */
   static getColumn(index, failOnMissingCell) {
     return (table) => table.GetColumn(index, unwrap(failOnMissingCell));
   }
+  /**
+   * Returns a column by its header.
+   * If the header is not found, returns None. Fills the column with empty cells for rows that do not have a value.
+   */
   TryGetColumnByHeader(header, failOnMissingCell) {
+    let i = void 0;
     const this$ = this;
-    return map$1((i) => this$.GetColumn(i, unwrap(failOnMissingCell)), tryFindIndex((x) => equals(x, header), this$.Headers));
+    const option_1 = tryFindIndex((x) => equals(x, header), this$.Headers);
+    return option_1 != null ? (i = value(option_1) | 0, this$.GetColumn(i, unwrap(failOnMissingCell))) : void 0;
   }
+  /**
+   * Returns a column by its header.
+   * If the header is not found, returns None. Fills the column with empty cells for rows that do not have a value.
+   */
   static tryGetColumnByHeader(header, failOnMissingCell) {
     return (table) => table.TryGetColumnByHeader(header, unwrap(failOnMissingCell));
   }
+  /**
+   * Returns the first column for that the header predicate returns true.
+   * If the header is not found, returns None. Fills the column with empty cells for rows that do not have a value.
+   */
   TryGetColumnByHeaderBy(headerPredicate, failOnMissingCell) {
+    let i = void 0;
     const this$ = this;
-    return map$1((i) => this$.GetColumn(i, unwrap(failOnMissingCell)), tryFindIndex(headerPredicate, this$.Headers));
+    const option_1 = tryFindIndex(headerPredicate, this$.Headers);
+    return option_1 != null ? (i = value(option_1) | 0, this$.GetColumn(i, unwrap(failOnMissingCell))) : void 0;
   }
+  /**
+   * Returns the first column for that the header predicate returns true.
+   * If the header is not found, returns None. Fills the column with empty cells for rows that do not have a value.
+   */
   static tryGetColumnByHeaderBy(headerPredicate, failOnMissingCell) {
     return (table) => table.TryGetColumnByHeaderBy(headerPredicate, unwrap(failOnMissingCell));
   }
+  /**
+   * Returns a column by its header. Fills the column with empty cells for rows that do not have a value.
+   */
   GetColumnByHeader(header, failOnMissingCell) {
     const this$ = this;
     const matchValue = this$.TryGetColumnByHeader(header, unwrap(failOnMissingCell));
@@ -479,8 +564,10 @@ class ArcTable {
     return (table) => table.GetColumnByHeader(header, unwrap(failOnMissingCell));
   }
   TryGetInputColumn() {
+    let i = void 0;
     const this$ = this;
-    return map$1((i) => this$.GetColumn(i), tryFindIndex((x) => x.isInput, this$.Headers));
+    const option_1 = tryFindIndex((x) => x.isInput, this$.Headers);
+    return option_1 != null ? (i = value(option_1) | 0, this$.GetColumn(i)) : void 0;
   }
   static tryGetInputColumn() {
     return (table) => table.TryGetInputColumn();
@@ -499,8 +586,10 @@ class ArcTable {
     return (table) => table.GetInputColumn();
   }
   TryGetOutputColumn() {
+    let i = void 0;
     const this$ = this;
-    return map$1((i) => this$.GetColumn(i), tryFindIndex((x) => x.isOutput, this$.Headers));
+    const option_1 = tryFindIndex((x) => x.isOutput, this$.Headers);
+    return option_1 != null ? (i = value(option_1) | 0, this$.GetColumn(i)) : void 0;
   }
   static tryGetOutputColumn() {
     return (table) => table.TryGetOutputColumn();
@@ -546,14 +635,14 @@ class ArcTable {
       const columnCount = this$.ColumnCount | 0;
       const newCellsCount = length(newCells) | 0;
       if (columnCount === 0) {
-        throw new Error("Table contains no columns! Cannot add row to empty table!");
+        throw new Exception("Table contains no columns! Cannot add row to empty table!");
       } else if (newCellsCount !== columnCount) {
-        throw new Error(`Cannot add a new row with ${newCellsCount} cells, as the table has ${columnCount} columns.`);
+        throw new Exception(`Cannot add a new row with ${newCellsCount} cells, as the table has ${columnCount} columns.`);
       }
       for (let columnIndex = 0; columnIndex <= this$.ColumnCount - 1; columnIndex++) {
-        const h = this$.Headers[columnIndex];
-        const column = CompositeColumn.create(h, [cells_1[columnIndex]]);
-        cells_1[columnIndex].ValidateAgainstHeader(h, true);
+        const h = item(columnIndex, this$.Headers);
+        CompositeColumn.create(h, [item(columnIndex, cells_1)]);
+        item(columnIndex, cells_1).ValidateAgainstHeader(h, true);
       }
       Unchecked_addRow(index_1, cells_1, this$.Headers, this$._values);
     } else {
@@ -574,12 +663,12 @@ class ArcTable {
     const columnCount = this$.RowCount | 0;
     const newCellsCount = length(newCells) | 0;
     if (columnCount === 0) {
-      throw new Error("Table contains no columns! Cannot add row to empty table!");
+      throw new Exception("Table contains no columns! Cannot add row to empty table!");
     } else if (newCellsCount !== columnCount) {
-      throw new Error(`Cannot add a new row with ${newCellsCount} cells, as the table has ${columnCount} columns.`);
+      throw new Exception(`Cannot add a new row with ${newCellsCount} cells, as the table has ${columnCount} columns.`);
     }
     ResizeArray_iteri((i, cell) => {
-      const h = this$.Headers[i];
+      const h = item(i, this$.Headers);
       SanityChecks_validateColumn(CompositeColumn.create(h, ResizeArray_singleton(cell)));
     }, cells);
     ResizeArray_iteri((columnIndex, cell_1) => {
@@ -624,9 +713,9 @@ class ArcTable {
       const columnCount = this$.ColumnCount | 0;
       const newCellsCount = length(newCells) | 0;
       if (columnCount === 0) {
-        throw new Error("Table contains no columns! Cannot add row to empty table!");
+        throw new Exception("Table contains no columns! Cannot add row to empty table!");
       } else if (newCellsCount !== columnCount) {
-        throw new Error(`Cannot add a new row with ${newCellsCount} cells, as the table has ${columnCount} columns.`);
+        throw new Exception(`Cannot add a new row with ${newCellsCount} cells, as the table has ${columnCount} columns.`);
       }
     }, rows);
     let enumerator = getEnumerator(rows);
@@ -634,8 +723,8 @@ class ArcTable {
       while (enumerator["System.Collections.IEnumerator.MoveNext"]()) {
         const row_1 = enumerator["System.Collections.Generic.IEnumerator`1.get_Current"]();
         for (let columnIndex = 0; columnIndex <= this$.ColumnCount - 1; columnIndex++) {
-          const h = this$.Headers[columnIndex];
-          row_1[columnIndex].ValidateAgainstHeader(h, true);
+          const h = item(columnIndex, this$.Headers);
+          item(columnIndex, row_1).ValidateAgainstHeader(h, true);
         }
       }
     } finally {
@@ -653,7 +742,7 @@ class ArcTable {
   AddRowsEmpty(rowCount, index) {
     const this$ = this;
     let row;
-    const collection = toArray(delay(() => collect((columnIndex) => singleton(getEmptyCellForHeader(this$.Headers[columnIndex], Unchecked_tryGetCellAt(columnIndex, 0, this$._values))), rangeDouble(0, 1, this$.ColumnCount - 1))));
+    const collection = toArray(delay(() => collect((columnIndex) => singleton(getEmptyCellForHeader(item(columnIndex, this$.Headers), Unchecked_tryGetCellAt(columnIndex, 0, this$._values))), rangeDouble(0, 1, this$.ColumnCount - 1))));
     row = Array.from(collection);
     const rows = ResizeArray_init(rowCount, (_arg) => row);
     this$.AddRows(rows, unwrap(index));
@@ -683,7 +772,7 @@ class ArcTable {
       SanityChecks_validateRowIndex(index, this$.RowCount, false);
     });
     const indexArr_1 = sortDescending(indexArr, {
-      Compare: comparePrimitives
+      Compare: (x, y) => comparePrimitives(x, y) | 0
     });
     indexArr_1.forEach((index_1) => {
       this$.RemoveRow(index_1);
@@ -707,6 +796,9 @@ class ArcTable {
   static getRow(index) {
     return (table) => table.GetRow(index);
   }
+  /**
+   * This function can be used to join two arc tables.
+   */
   Join(table, index, joinOptions, forceReplace) {
     const this$ = this;
     const joinOptions_1 = defaultArg(joinOptions, "headers");
@@ -732,7 +824,7 @@ class ArcTable {
       iterate((x_1) => {
         StringBuilder__AppendLine_Z721C83C5(sb, `Duplicate \`${x_1.HeaderType}\` at index ${x_1.Index1} and ${x_1.Index2}.`);
       }, duplicates);
-      throw new Error(toString(sb));
+      throw new Exception(toString(sb));
     }
     ResizeArray_iter((x_2) => {
       SanityChecks_validateColumn(x_2);
@@ -754,52 +846,65 @@ class ArcTable {
   }
   AddProtocolTypeColumn(types, index, forceReplace) {
     const this$ = this;
-    const cells = map$1((a) => ResizeArray_map(CompositeCell_Term, a), types);
-    this$.AddColumn(CompositeHeader_ProtocolType(), unwrap(cells), unwrap(index), unwrap(forceReplace));
+    let cells;
+    const option_1 = types;
+    cells = option_1 != null ? ResizeArray_map(CompositeCell_Term, value(option_1)) : void 0;
+    this$.AddColumn(CompositeHeader.ProtocolType, unwrap(cells), unwrap(index), unwrap(forceReplace));
   }
   AddProtocolVersionColumn(versions, index, forceReplace) {
     const this$ = this;
-    const cells = map$1((a) => ResizeArray_map(CompositeCell_FreeText, a), versions);
-    this$.AddColumn(CompositeHeader_ProtocolVersion(), unwrap(cells), unwrap(index), unwrap(forceReplace));
+    let cells;
+    const option_1 = versions;
+    cells = option_1 != null ? ResizeArray_map(CompositeCell_FreeText, value(option_1)) : void 0;
+    this$.AddColumn(CompositeHeader.ProtocolVersion, unwrap(cells), unwrap(index), unwrap(forceReplace));
   }
   AddProtocolUriColumn(uris, index, forceReplace) {
     const this$ = this;
-    const cells = map$1((a) => ResizeArray_map(CompositeCell_FreeText, a), uris);
-    this$.AddColumn(CompositeHeader_ProtocolUri(), unwrap(cells), unwrap(index), unwrap(forceReplace));
+    let cells;
+    const option_1 = uris;
+    cells = option_1 != null ? ResizeArray_map(CompositeCell_FreeText, value(option_1)) : void 0;
+    this$.AddColumn(CompositeHeader.ProtocolUri, unwrap(cells), unwrap(index), unwrap(forceReplace));
   }
   AddProtocolDescriptionColumn(descriptions, index, forceReplace) {
     const this$ = this;
-    const cells = map$1((a) => ResizeArray_map(CompositeCell_FreeText, a), descriptions);
-    this$.AddColumn(CompositeHeader_ProtocolDescription(), unwrap(cells), unwrap(index), unwrap(forceReplace));
+    let cells;
+    const option_1 = descriptions;
+    cells = option_1 != null ? ResizeArray_map(CompositeCell_FreeText, value(option_1)) : void 0;
+    this$.AddColumn(CompositeHeader.ProtocolDescription, unwrap(cells), unwrap(index), unwrap(forceReplace));
   }
   AddProtocolNameColumn(names, index, forceReplace) {
     const this$ = this;
-    const cells = map$1((a) => ResizeArray_map(CompositeCell_FreeText, a), names);
-    this$.AddColumn(CompositeHeader_ProtocolREF(), unwrap(cells), unwrap(index), unwrap(forceReplace));
+    let cells;
+    const option_1 = names;
+    cells = option_1 != null ? ResizeArray_map(CompositeCell_FreeText, value(option_1)) : void 0;
+    this$.AddColumn(CompositeHeader.ProtocolREF, unwrap(cells), unwrap(index), unwrap(forceReplace));
   }
+  /**
+   * Get functions for the protocol columns
+   */
   GetProtocolTypeColumn() {
     const this$ = this;
-    return this$.GetColumnByHeader(CompositeHeader_ProtocolType());
+    return this$.GetColumnByHeader(CompositeHeader.ProtocolType);
   }
   GetProtocolVersionColumn() {
     const this$ = this;
-    return this$.GetColumnByHeader(CompositeHeader_ProtocolVersion());
+    return this$.GetColumnByHeader(CompositeHeader.ProtocolVersion);
   }
   GetProtocolUriColumn() {
     const this$ = this;
-    return this$.GetColumnByHeader(CompositeHeader_ProtocolUri());
+    return this$.GetColumnByHeader(CompositeHeader.ProtocolUri);
   }
   GetProtocolDescriptionColumn() {
     const this$ = this;
-    return this$.GetColumnByHeader(CompositeHeader_ProtocolDescription());
+    return this$.GetColumnByHeader(CompositeHeader.ProtocolDescription);
   }
   GetProtocolNameColumn() {
     const this$ = this;
-    return this$.GetColumnByHeader(CompositeHeader_ProtocolREF());
+    return this$.GetColumnByHeader(CompositeHeader.ProtocolREF);
   }
   TryGetProtocolNameColumn() {
     const this$ = this;
-    return this$.TryGetColumnByHeader(CompositeHeader_ProtocolREF());
+    return this$.TryGetColumnByHeader(CompositeHeader.ProtocolREF);
   }
   GetComponentColumns() {
     const this$ = this;
@@ -811,17 +916,27 @@ class ArcTable {
       }
     }, this$.Headers);
   }
+  /**
+   * This will rescan the value map of the table, so that it is up to date with the current values.
+   * This is useful if you have changed the values of the table and want to update the value map.
+   */
   RescanValueMap() {
     const this$ = this;
     this$._values.RescanValueMap();
   }
+  /**
+   * Splits the table rowWise into a collection of tables, so that each new table has only one value for the given column
+   */
   static SplitByColumnValues(columnIndex) {
     return (table) => ResizeArray_mapi((i, indexGroup) => {
       const headers = table.Headers;
       const rows = ResizeArray_map((i_1) => table.GetRow(i_1, true), indexGroup);
       return ArcTable.createFromRows(table.Name, headers, rows);
-    }, ResizeArray_map((tupledArg) => ResizeArray_map((tuple_1) => tuple_1[0], tupledArg[1]), ResizeArray_groupBy((tuple) => tuple[1], ResizeArray_indexed(table.GetColumn(columnIndex).Cells))));
+    }, ResizeArray_map((tupledArg) => ResizeArray_map((tuple_1) => tuple_1[0] | 0, tupledArg[1]), ResizeArray_groupBy((tuple) => tuple[1], ResizeArray_indexed(table.GetColumn(columnIndex).Cells))));
   }
+  /**
+   * Splits the table rowWise into a collection of tables, so that each new table has only one value for the given column
+   */
   static SplitByColumnValuesByHeader(header) {
     return (table) => {
       const index = tryFindIndex((x) => equals(x, header), table.Headers);
@@ -833,9 +948,15 @@ class ArcTable {
       }
     };
   }
-  static get SplitByProtocolREF() {
-    return (table) => ArcTable.SplitByColumnValuesByHeader(CompositeHeader_ProtocolREF())(table);
+  /**
+   * Splits the table rowWise into a collection of tables, so that each new table has only one value for the ProtocolREF column
+   */
+  static SplitByProtocolREF(table) {
+    return ArcTable.SplitByColumnValuesByHeader(CompositeHeader.ProtocolREF)(table);
   }
+  /**
+   * This method is meant to update an ArcTable stored as a protocol in a study or investigation file with the information from an ArcTable actually stored as an annotation table
+   */
   static updateReferenceByAnnotationTable(refTable, annotationTable) {
     const refTable_1 = refTable.Copy();
     const annotationTable_1 = annotationTable.Copy();
@@ -859,26 +980,41 @@ class ArcTable {
     }
     return refTable_1;
   }
+  /**
+   * Append the rows of another table to this one
+   * 
+   * The headers of the other table will be aligned with the headers of this table
+   * 
+   * The name of table 2 will be ignored
+   */
   static append(table1, table2) {
-    const getList = (t) => toList(delay(() => map((row) => toList(mapIndexed((i, c) => [t.Headers[i], c], t.GetRow(row, true))), rangeDouble(0, 1, t.RowCount - 1))));
+    const getList = (t) => toList(delay(() => map((row) => toList(mapIndexed((i, c) => [item(i, t.Headers), c], t.GetRow(row, true))), rangeDouble(0, 1, t.RowCount - 1))));
     const patternInput = Unchecked_alignByHeaders(false, append(getList(table1), getList(table2)));
     return ArcTable.fromArcTableValues(table1.Name, patternInput[0], patternInput[1]);
   }
+  /**
+   * Pretty printer
+   */
   toString() {
     const this$ = this;
     const rowCount = this$.RowCount | 0;
-    return join("\n", toList(delay(() => append$1(singleton(`Table: ${this$.Name}`), delay(() => append$1(singleton("-------------"), delay(() => append$1(singleton(join("	|	", map(toString, this$.Headers))), delay(() => rowCount > 50 ? append$1(map((rowI) => join("	|	", map(toString, this$.GetRow(rowI))), rangeDouble(0, 1, 19)), delay(() => append$1(singleton("..."), delay(() => map((rowI_1) => join("	|	", map(toString, this$.GetRow(rowI_1))), rangeDouble(rowCount - 20, 1, rowCount - 1)))))) : rowCount === 0 ? singleton("No rows") : map((rowI_2) => join("	|	", map(toString, this$.GetRow(rowI_2))), rangeDouble(0, 1, rowCount - 1)))))))))));
+    return join("\n", toList(delay(() => append$1(singleton(concat("Table: ", this$.Name)), delay(() => append$1(singleton("-------------"), delay(() => append$1(singleton(join("	|	", map(toString, this$.Headers))), delay(() => rowCount > 50 ? append$1(map((rowI) => join("	|	", map(toString, this$.GetRow(rowI))), rangeDouble(0, 1, 19)), delay(() => append$1(singleton("..."), delay(() => map((rowI_1) => join("	|	", map(toString, this$.GetRow(rowI_1))), rangeDouble(rowCount - 20, 1, rowCount - 1)))))) : rowCount === 0 ? singleton("No rows") : map((rowI_2) => join("	|	", map(toString, this$.GetRow(rowI_2))), rangeDouble(0, 1, rowCount - 1)))))))))));
   }
   StructurallyEquals(other) {
     const this$ = this;
     return safeHash(this$) === safeHash(other);
   }
+  /**
+   * Use this function to check if this ArcTable and the input ArcTable refer to the same object.
+   * 
+   * If true, updating one will update the other due to mutability.
+   */
   ReferenceEquals(other) {
     const this$ = this;
     return this$ === other;
   }
   Equals(other) {
-    let table;
+    let table = void 0;
     const this$ = this;
     return other instanceof ArcTable && (table = other, this$.StructurallyEquals(table));
   }