A file that will not load can interrupt an otherwise straightforward modeling session. The first useful question is not simply “Why is SAMSON broken?” but “Which part of the import path needs attention?” SAMSON uses importers to read files and bring structures, maps, meshes, and other objects into a document. Knowing that gives you a practical way to narrow down the problem before you try another file or search for a workaround.
Start with the format
Check whether the file’s format is supported by SAMSON. The supported formats reference is the place to verify which formats can be imported. A file extension can be a useful clue, but it is better to check the supported-format list than to assume that a familiar-looking filename means the file can be read.
If you are unsure what the file contains, identify its source and intended format before changing it. Keep the original file unchanged while investigating. That makes it easier to return to the source if you need to compare versions or ask for help.
Separate the format question from the workflow question
There are two different problems that can look alike: the format may not be supported, or you may need help with the steps for opening a file. The Loading molecules guide covers the task workflow for opening files, fetching structures, and understanding documents. Use it when you know what you want to load but need help with the process.
This distinction saves time. If you are looking for instructions, consult the loading guide. If you are trying to confirm whether a file type is recognized, consult the formats reference. If the format is supported but you still cannot proceed, write down what you tried and the result so you can describe the issue clearly.
Understand what an importer does
An importer is the component that parses a file so SAMSON can load its contents into a document. Different kinds of content—such as molecular structures, electron-density maps, and meshes—may be handled by different importers. SAMSON includes default importers, and additional importers can be obtained from SAMSON Connect.
This matters when you are deciding what to do next. If a format is missing from the supported list, look for an appropriate importer rather than assuming that an exporter will solve the problem. Importers read files into SAMSON; exporters are the matching extension family for writing files out.
A short checklist before asking for help
- Record the file format and where the file came from.
- Check the supported formats list.
- If the format is supported, consult Loading molecules for the opening workflow.
- Note what you attempted and what happened, without modifying your only copy of the file.
- If the needed importer is not available, contact the SAMSON team at contact@samson-connect.net.
If you are a developer looking to create an importer, the documentation points to generating SAMSON Extensions as a starting point.
For the full reference, visit the SAMSON Importers documentation.
Note: SAMSON and all SAMSON Extensions are free for non-commercial use. Get SAMSON.