---

How use it

This portal is the main interface for exploring taxa, accepted names, synonymy, and distribution data for Cerambycidae of the Palaearctic Region within the Catalogue of Palaearctic Coleoptera framework. It combines text search with geographic filtering in one page.

What This Page Does

The home page returns either a list of matching records or a structured taxon report. If the query matches a higher-rank taxon such as a family, subfamily, tribe, genus, or subgenus, the result is shown as a taxonomic block. If the query behaves like a direct name search, the result is shown as a list of matched species or subspecies.

For genus-level results you can also jump to a more focused report using the small genus ... link shown next to a matching line.

How To Search

• If the query field is empty, the default search is Cerambycidae. You can then generate a standalone report, for example https://entomo.pl/cpc/html/cerambycidae.html, with footer actions such as Share, Copy link, Download HTML, and Continue search.
• Minimum query length is 3 characters.
• Type taxon names (for example Cerambycinae, Rosalia, Clytini) or species/subspecies names.
• Add author or year fragments to narrow broad results.
• Case-sensitive search is optional, so Sama and sama can return different results when this option is enabled.
• Exact word match: wrap the query in double quotes, e.g. "scale", to avoid partial matches. Without quotes, scale can also match broader forms such as Escalera, Scalenus, and unidiscale.
• Geographic tokens in the query are recognized only when typed in uppercase, for example GR, TR, E, N, A, CH. Lowercase forms are treated as normal text.
• Token order is flexible: Ceramb GR and GR Ceramb are interpreted consistently.

Layout And Filters

• Left column: search field + display options.
• Right column: Regions and Country codes.
• Regions codes: E = Europe, N = North Africa, A = Asia, CH = China regions and Taiwan.
• Country codes are filtered dynamically by selected region(s).
• Some codes can belong to more than one region context (for example shared geopolitical usage in CPC coding).
• The country list uses the CPC code-name mapping (for example GR - Greece, AF - Afghanistan).

Search Options

• Case-sensitive search: when enabled, uppercase/lowercase is respected in text matching.
• Extend search to synonyms: expands matching to synonym records stored in cpc_names_raw. When disabled, the search stays focused on accepted/displayed records.
• Hide synonymy: keeps synonym lines out of the visible result list. This affects display, not the underlying accepted match logic.
• Hide subgenera: removes explicit subgenus lines from the visible report.
• Hide distribution and comments: shortens the visible text by removing distribution blocks and bracketed metadata.
• Show genus origin: reveals the original genus information used in the source line. When this option is off, the display is shortened to a cleaner zoological citation form.
• Clear: clears the current search text and active filters, returning the interface to the default empty search view.

Genus Origin Logic

The genus origin field preserves information about the original combination. This is taxonomically important because a taxon originally described in a different genus should display the author in parentheses when the original genus is hidden from the visible line.

Example:

With Show genus origin disabled, the shortened visible form becomes:

The page marker after the colon and the original genus are removed from the visible line, but the parentheses rule is preserved.

Remarks And Navigation

Remarks are opened by clicking a #number marker next to a taxon line. Each remark can also be opened directly by URL with the remark=NUMBER parameter, so a specific remark view can be bookmarked or shared.

The remark window now supports two navigation scopes:

• Context: moves only through the unique remarks visible in the current result view, in the order in which they first appear on the page.
• Global: moves numerically through the full remarks table, even beyond the currently visible result context.

This means the default contextual mode is useful for thematic browsing of the current taxon or result block, while global mode is useful for direct sequential review of all remarks.

Keyboard support is available while the remark window is open: Left Arrow = previous remark, Right Arrow = next remark, Escape = close.

Geographic Filtering

Use region and country selectors in the right column. You can choose one or multiple regions and then select country codes from the filtered list. This avoids guessing code spelling and keeps filtering consistent.

Sample searches

Searches for Oberea in Italy.
https://entomo.pl/cpc/index.php?q=Oberea+IT

Searches for Plagionotus in North Africa.
https://entomo.pl/cpc/index.php?q=Plagionotus+N&hide_remarks=0

Searches for Clytini in Algeria.
https://entomo.pl/cpc/index.php?q=Clytini+AG&region_tokens[]=N&country_tokens[]=AG&edit_search=1

Searches by a name fragment and limits the results to Greece.
https://entomo.pl/cpc/index.php?q=Trichof+GR&hide_remarks=0

Searches for Vadonia in Greece.
https://entomo.pl/cpc/index.php?q=Vadonia+GR

Searches for Agapanthia in Turkey.
https://entomo.pl/cpc/index.php?q=Agapanthia+TR

Searches for taxa matching Dorc that occur simultaneously in Turkey, Greece and Bulgaria.
https://entomo.pl/cpc/index.php?q=Dorc+TR+GR+BU&hide_remarks=0

Shows a simplified checklist for the same shared set in Turkey, Greece and Bulgaria.
https://entomo.pl/cpc/index.php?q=Dorc+TR+GR+BU&hide_remarks=0&checklist=1&country_tokens%5B%5D=BU&country_tokens%5B%5D=GR&country_tokens%5B%5D=TR

Searches for Phyto taxa associated with both North Africa and Europe.
https://entomo.pl/cpc/index.php?q=Phyto+N+E

Narrows the search to Phyto taxa associated simultaneously with Bulgaria, Greece and Turkey.
https://entomo.pl/cpc/index.php?q=Phyto+BU+GR+TR&hide_remarks=0

Searches for species of the tribe Clytini described in the years 1990-1999, with the Checklist option enabled.
https://entomo.pl/cpc/index.php?q=Clytin+199&hide_remarks=0&checklist=1&hide_meta=1&hide_remarks=1

Searches for species described by Gianfranco Sama in the years 2010-2019.
https://entomo.pl/cpc/index.php?q=Sama+201&hide_remarks=0&hide_syn=1&checklist=1&hide_meta=1&hide_remarks=1

Note: For queries such as Sama 201, enable Case-sensitive search to avoid accidental matches inside taxon names.

How Results Behave

• Result for shows the interpreted query/filter context and is displayed above counters.
• Species / Subspecies / Synonyms are calculated for the full filtered dataset, not only the currently visible result block.
• Synonyms counter remains global for the active filters even when Hide synonymy is enabled.
• Page currently remains fixed to a single full result view because pagination is disabled.
• Generate HTML exports the current result view as a standalone HTML file (if enabled in the current interface mode).

Reports

A report is the structured view used when the query resolves to a taxonomic unit such as a family, subfamily, tribe, genus, or subgenus. Instead of showing a flat list of matches, the page builds a taxonomic block in hierarchical order.

• Taxon report appears when the query is interpreted as a real taxon rather than only as a free-text match.
• Report structure may include parent rank, report header, subordinate taxa, species or subspecies lines, and optionally synonym lines.
• Species counter shows how many species or subspecies are currently counted inside that report block, not how many display lines are visible after hiding options.
• Display filters such as hiding synonymy, subgenera, metadata, or genus origin change what you see on screen, but they do not redefine the underlying taxonomic unit of the report.
• Genus link next to a result line opens a focused genus report built from that accepted genus.

Reports are especially useful for browsing a higher-rank group in taxonomic order. A general search result answers the question "what matched?", while a report answers the question "what belongs here, and how is it arranged?".

When you use Generate HTML, the current report view is exported in its visible form. That means the exported file respects the active display switches, including synonymy, metadata, and genus-origin presentation.