When a Molecular File Won’t Open: Find the Right Import Path

A file that will not load can interrupt an otherwise straightforward modeling task. The first useful question is not simply “What is wrong with this file?” but “Does SAMSON have an importer for this format, and am I following the right workflow?” Those questions help separate a format-support issue from a file-opening question.

What an importer does

An importer is an extension that parses a file and brings its contents into a SAMSON document. Depending on the format, the content may be a molecular structure, an electron-density map, a mesh, or another supported object. SAMSON includes default importers, and additional importers can be added from SAMSON Connect.

Thinking in terms of importers is useful because a file extension is not just a label: it points to the kind of parser SAMSON needs to interpret the file. A structure file, a map, and a mesh may represent very different kinds of data, even if they are all part of the same modeling project.

A practical check before troubleshooting further

  1. Identify what you are trying to load. Is it a molecular structure, an electron-density map, a mesh, or another object? Knowing the intended content helps you look for the relevant format rather than treating every file as the same kind of input.
  2. Check the supported-formats list. The supported formats reference is the place to check whether SAMSON can import the format you have. This is a more reliable starting point than guessing from a filename alone.
  3. Use the loading guide for the opening workflow. If you know the format is supported but are unsure how to open a local file or work with the resulting document, consult Loading molecules. The importer reference describes the extension family; the loading guide covers the task of opening files.
  4. Look for an additional importer if needed. SAMSON’s default importers are not the only option: more importers can be added from SAMSON Connect. Check there when your workflow depends on a format that is not available by default.
  5. Ask about a missing format. If you cannot find an importer for the format you need, the documentation invites users to contact SAMSON support. Include the format name and what you are trying to load so the request is clear.

Keep importing and exporting distinct

It is easy to mix up importing and exporting, especially when moving between tools. Importers are for reading files into SAMSON. Exporters are the corresponding extension family for writing files out. If your goal is to bring data into a document, start with the importer and supported-format references; if your goal is to save data in a file format, see the Exporters page.

When you want to build support yourself

Some users may need to develop an importer for a workflow or format that is not covered by the available options. The importer reference points developers to the documentation on generating SAMSON Extensions. For a broader overview of extension-based capabilities, see Extending SAMSON.

The short version: identify the kind of data, check the supported formats, then choose the loading guide or an additional importer as appropriate. To learn more, see the SAMSON Importers reference.

Note: SAMSON and all SAMSON Extensions are free for non-commercial use. Get SAMSON.

Comments are closed.