OptimizationResultCollection

pydantic model openff.qcsubmit.results.OptimizationResultCollection[source]

A class which stores a reference to, and allows the retrieval of, data from a single optimization result record stored in a QCFractal instance.

Show JSON schema
{
   "title": "OptimizationResultCollection",
   "description": "A class which stores a reference to, and allows the retrieval of, data from\na single optimization result record stored in a QCFractal instance.",
   "type": "object",
   "properties": {
      "entries": {
         "title": "Entries",
         "description": "The entries stored in this collection in a dictionary of the form ``collection.entries['qcfractal_address'] = [record_1, ..., record_N]``.",
         "type": "object",
         "additionalProperties": {
            "type": "array",
            "items": {
               "$ref": "#/definitions/OptimizationResult"
            }
         }
      },
      "provenance": {
         "title": "Provenance",
         "description": "A dictionary which can contain provenance information about how and why this collection was curated.",
         "default": {},
         "type": "object"
      }
   },
   "required": [
      "entries"
   ],
   "definitions": {
      "OptimizationResult": {
         "title": "OptimizationResult",
         "description": "A class which stores a reference to, and allows the retrieval of, data from\na single optimization result record stored in a QCFractal instance.",
         "type": "object",
         "properties": {
            "type": {
               "title": "Type",
               "default": "optimization",
               "enum": [
                  "optimization"
               ],
               "type": "string"
            },
            "record_id": {
               "title": "Record Id",
               "description": "The unique id assigned to the record referenced by this result.",
               "type": "string"
            },
            "cmiles": {
               "title": "Cmiles",
               "description": "The canonical, isomeric, explicit hydrogen, mapped SMILES representation of the molecule that this record was created for.",
               "type": "string"
            },
            "inchi_key": {
               "title": "Inchi Key",
               "description": "The fixed hydrogen layer InChI key generated from the ``cmiles`` representation. This may be used as a hash for the molecule referenced by this record.",
               "type": "string"
            }
         },
         "required": [
            "record_id",
            "cmiles",
            "inchi_key"
         ]
      }
   }
}

Fields
  • entries (Dict[str, List[openff.qcsubmit.results.results.OptimizationResult]])

Validators

field entries: Dict[str, List[openff.qcsubmit.results.results.OptimizationResult]] [Required]

The entries stored in this collection in a dictionary of the form collection.entries['qcfractal_address'] = [record_1, ..., record_N].

Validated by
  • _validate_entries

classmethod from_datasets(datasets, spec_name='default')[source]

Retrieve the COMPLETE record ids referenced by the specified datasets.

Parameters
Returns

A results collection object containing the record ids and a minimal amount of associated metadata such as the CMILES of the associated molecule.

Return type

openff.qcsubmit.results.results.OptimizationResultCollection

classmethod from_server(client, datasets, spec_name='default')[source]

Retrieve (and deduplicate) the COMPLETE record ids referenced by the specified datasets.

Parameters
  • client (qcportal.client.FractalClient) – The fractal client that should be used to interface with the running QCFractal instance which stores the datasets and their associated results records.

  • datasets (Union[str, Iterable[str]]) – The names of the datasets

  • spec_name (str) – The name of the QC specification that the records to retrieve should have been computed using.

Returns

A results collection object containing the record ids and a minimal amount of associated metadata such as the CMILES of the associated molecule.

Return type

openff.qcsubmit.results.results.OptimizationResultCollection

to_records()[source]

Returns the native QCPortal record objects for each of the records referenced in this collection along with a corresponding OpenFF molecule object.

Each molecule will contain the minimum energy conformer referenced by the record.

Return type

List[Tuple[qcportal.models.records.OptimizationRecord, openff.toolkit.topology.molecule.Molecule]]

to_basic_result_collection(driver=None)[source]

Returns a basic results collection which references results records which were created from the final structure of one of the optimizations in this collection, and used the same program, method, and basis as the parent optimization record.

Parameters

driver (Optional[Union[List[str], str]]) – Optionally specify the driver to filter by.

Returns

The results collection referencing records created from the final optimized structures referenced by this collection.

Return type

openff.qcsubmit.results.results.BasicResultCollection

create_basic_dataset(dataset_name, description, tagline, driver, metadata=None, qc_specs=None)[source]

Create a basic dataset from the results of the current dataset.

Notes

  • This may be used, for example, to evaluate the hessians of each optimized geometry.

Parameters
  • dataset_name (str) – The name that will be given to the new dataset.

  • tagline (str) – The tagline that should be given to the new dataset.

  • description (str) – The description that should be given to the new dataset.

  • driver (qcportal.models.common_models.DriverEnum) – The driver to be used on the basic dataset.

  • metadata (Optional[openff.qcsubmit.common_structures.Metadata]) – The metadata for the new dataset.

  • qc_specs (Optional[List[openff.qcsubmit.common_structures.QCSpec]]) – The QC specifications to be used on the new dataset. If no value is provided, the default OpenFF QCSpec will be added.

Returns

The created basic dataset.

Return type

openff.qcsubmit.datasets.datasets.BasicDataset