Description
- Users import structures and metadata from a CSV file into Katalyst using the Import CSV file tool (right-click on reaction design widget → Import CSV file).
The import may fail with an "attachment failed" error, or
Materials may not populate correctly across all Katalyst windows.
This feature has no built-in configuration UI or downloadable template. The CSV file must follow a specific column naming convention for Katalyst to parse it correctly.
Solution
Verify Column Headers
Katalyst recognizes only predefined column names. If the CSV file contains incorrect, misspelled, or unsupported headers, the corresponding data may be ignored or the import may fail.
The expected headers include fields such as:
Ensure that all column names exactly match the required naming convention.
Remove Unsupported Columns
Any columns that Katalyst cannot map to a recognized field are ignored during import. Review the CSV file and remove or rename unsupported columns as needed.
Check for Formatting Issues
Import failures can also be caused by formatting problems within the CSV file, including:
- Extra header rows
- Merged cells
- Hidden characters
- Blank rows before the header
- Inconsistent delimiters
Ensure that the file contains a single header row followed only by data rows.
Verify Well Position Formatting
Katalyst requires well locations to be provided as separate Row and Column values.
Correct format
If a single Well column is used, split the values into separate Row and Column columns before importing.
Verify InChI Values
All InChI values must contain the full standard prefix:
1 InChI=1S/
If the prefix is missing, Katalyst may recognize the compound in some views but fail to add it to the Materials Table or other related components.
Recommended Validation Steps
Before importing:
- Confirm that all required column headers are present and spelled correctly.
- Verify that well locations are provided using separate Row and Column fields.
- Ensure all InChI values begin with InChI=1S/.
- Remove unsupported columns and unnecessary formatting.
- Save the file as a standard CSV format and retry the import.
Following these requirements should allow the reaction design, materials, and associated metadata to be imported successfully into Katalyst.
Comments
0 comments
Article is closed for comments.