Skip to main content

How to use CMF-CW

CMF-CW allows you to submit chemical search terms and automatically checks them against CW-control lists annotated with structures and metadata. On this page, we explain how to use the web interface—how to enter single or multiple search terms, select which CW-control lists to search, choose services for converting search terms into molecular structures, and configure the available search settings—as well as how to run the search and interpret the standard and verbose reports.

Screenshot of the CMF-CW interface
Figure: The CMF-CW web interface. Enter your search term or upload a file, select the desired options, and run the search.

Important: Verifying All Results. Automated searches are powerful but not perfect. We recommend manually verifying all results, as both false positives and false negatives are possible. Follow the instructions below to launch a search and interpret the results.


Select your search mode and enter your search term(s)

Either type a search term or upload a file in TXT or SDF format.

Use search terms that can be converted to structures algorithmically.

See How CMF-CW Works for more details on supported identifiers and how they are interpreted.

Choose which “CW-Control Lists” to search against

These include the Chemical Weapons Convention (CWC) Schedules, the Australia Group (AG) Chemical Weapons Precursors List, and the Wassenaar Arrangement (WA) Munitions List 7.

You can select one or more lists depending on your needs.

Select the “Search Term to SMILES Services”

These services are used by CMF-CW to translate your search term into a text string that represents its chemical structure (in SMILES format), which is in turn converted to a molecular structure object by CMF-CW. This conversion is necessary to check your search term against the structures in the annotated lists of controlled chemicals. Without this conversion, your search term can only be checked against the textual metadata in the annotated lists of controlled chemicals.

If you upload an SDF file, or your search term is a structural identifier in SMILES or InChI format, the structures are extracted directly by CMF-CW and do not require translation through these services.

Available services include:

It is recommended to select all services: they are processed in sequence until one successfully yields a structure. However, extra care is needed when the search term is a numerical database identifier, as using the wrong service can yield incorrect results.

Numerical database identifiers.

See the How CMF-CW Works page for more information and guidance on how these services handle different types of search terms.

Configure “Search Settings”

These settings determine how your search term is processed and how the results are displayed following your search.

After you have entered your search term and selected the desired settings, click the Run Search button to launch the search.

Report

After your search is complete, the CMF-CW webpage will display a report. Additionally, a green Download Report button will be displayed next to the Run Search button. Click it to download the report in HTML format. If you submit multiple search terms using a TXT or SDF file, the report will group the results for each search term into separate boxes, each marked with a gray border. The report will contain different amounts of information, depending on whether the verbose option was selected.

Standard report

Standard reports are divided into two sections: a Search Term section and a Matches Section. Depending on how the matches were found, this section can have a Matches in Structure Search and/or a Matches in Metadata Search component. If the search did not yield any matches, a No Matches Found message is shown.

Search Term

In the Search Term section, a standard report will include the following components.

Verify all results. Manual verification of all results is strongly recommended, as both false positives and false negatives are possible. A Match (Red Border) should be checked for false positives; a No-Match (White or Orange Border) should be checked for false negatives. A manual follow-up is particularly important for an Orange Border result, which means no structure could be generated for your search term. In this case, the search relied only on metadata and could not perform a more thorough structural comparison, increasing the chance of a missed match.

Matches in Structure Search

If the structure search yielded one or more matches with the entries in the CW-control lists, the Matches Section will have a Matches in Structure Search component (see Example 1s). If the Generate Variants option was selected, the report will indicate, for each match, whether the matching chemical is the structure corresponding to the search term or a variant of the structure corresponding to the search term. If it is a variant, you can select the Show All Variants in Report option to inspect which variant produced a match. With the Show All Variants in Report option selected, the structure box will show all the variants produced by CMF-CW, each labeled with a progressive variant number. Concomitantly, the Matches in Structure Search section of the report will indicate the variant number that produced the match.

Matches in Metadata Search

If the metadata search yielded one or more matches, the Matches Section will have a Matches in Metadata Search component (see Example 2s). For each entry of the CW-control lists that matches the search term, the report will provide the same information described above for the Matches in Structure Search section. Importantly, if, for a search term, a match with the same entry of a CW-control list is found in both the structure and metadata search, unless the verbose option is selected, the match is only shown once (under Matched in Structure Search) to avoid redundancy.

No Matches Found

If the search did not produce any matches, the Matches Section will show a No Matches Found message (see Example 3s). If the search term could not be converted into a structure, the following message is shown as well: “Note: No matches found, but the search term could not be converted to a structure – further checking is warranted” (see Example 4s). While manually double-checking the results is always advisable, this is particularly important when the search term could not be converted into a structure.

Verbose report

Search Term

In the Search Term section, in addition to the information included in the standard report, a verbose report will include the following information (compare the standard reports in Examples 1s-4s to the verbose reports in Examples 1v-4v).

Variants

For each variant of the search term produced by CMF-CW, a verbose report will label each variant with a progressive number (compare Example 1s and Example 1v). Moreover, for each variant, it will include the following information.

If no variants for your search term were produced by CMF-CW, this will be indicated in the verbose report.

Matches Sections

In a verbose report, the Matches Section is structured in the same way as in a standard report. However, unlike in a standard report, if, for a search term, a match with the same entry of a CW-control lists is found in both the structure and metadata search, the same match is shown twice, once under Matches in Structure Search and once under Matches in Metadata Search.

Sample Reports

The examples below demonstrate how CMF-CW presents results in both standard and verbose modes across a variety of scenarios: whether a match was found or not, and whether the search term could be successfully converted into a molecular structure. Each report shows how these outcomes are visually represented, including the color-coded structure box (red, white, or orange border). Click each example below to expand and view the full report.

Standard Reports

Example 1s: Triethanolamine Hydrochloride – Search term successfully converted to molecular structure and match found (red border)
Example 2s: Ricin – Search term not converted to molecular structure and match found (red border)
Example 3s: Triethylamine Hydrochloride – Search term successfully converted to molecular structure and no match found (white border)
Example 4s: Botulinum Toxin – Search term not converted to molecular structure and no match found (orange border)

Verbose Reports

Example 1v: Triethanolamine Hydrochloride – Search term successfully converted to molecular structure and match found (red border), verbose report
Example 2v: Ricin – Search term not converted to molecular structure and match found (red border), verbose report
Example 3v: Triethylamine Hydrochloride – Search term successfully converted to molecular structure and no match found (white border), verbose report
Example 4v: Botulinum Toxin – Search term not converted to molecular structure and no match found (orange border), verbose report

Learn More and Launch CMF-CW

To explore CMF-CW in more detail, visit the following pages:

When you are ready, launch the CMF-CW screening tool.

References

  1. Report of the Scientific Advisory Board on Developments in Science and Technology for the Fourth Special Session of the Conference of the States Parties to Review the Operation of the Chemical Weapons Convention. Fourth Review Conference of the Chemical Weapons Convention, RC-4/DG.1, 30 April 2018, p. 6: “...if a chemical is included within a schedule, then all possible isotopically-labeled forms and stereoisomers of that chemical should be included…”
  2. Wassenaar Arrangement, Public Documents, Volume II, List of Dual-Use Goods and Technologies and Munitions List, 2024, p. 3 and p. 181: “The list applies to chemicals of the same structural formula (including hydrates) regardless of name or CAS number.”
  3. The Australia Group, Export Control List: Chemical Weapons Precursors: “Chemicals of the same structural formula (e.g., hydrates, isotopically-labeled forms or all possible stereoisomers) are controlled regardless of name or CAS number.”