Linking to The C. V. Starr Virtual Herbarium

Introduction

This guide is for those who wish to construct URLs that will link to searches against The C. V. Starr Virtual Herbarium of The New York Botanical Garden. It explains how the URL is made, which parameters are available for searching, and gives examples of values to use for those parameters.

Constructing the URL

URLs should be made using this example:

http://sweetgum.nybg.org/science/vh/specimen_list.php?DetFiledAsFamilyLocal=Lauraceae&DetFiledAsGenusLocal=Nectandra&DetFiledAsTaxonLocal=Nectandra lanceolata var.parvifolia Mez&DetFiledAsTypeStatus=isotype&ColBarcode=355462&LimitPerPage=100

This URL is made up of:

The server location: http://sweetgum.nybg.org/science/vh/specimen_list.php
The parameter (field) name and the parameter value in the format: parameter (field) name + comparison operator + parameter value (separated by "&")
The number of records per page to display: &LimitPerPage=100 (100 is optimum; increasing this number results in longer times to return records to the browser)

Check the table below to see examples of parameters and values.

Comparison Operators

Parameters and their values are separated by a comparison operator, which is:

1. The equal sign (=)

Parameters

Name Comparison Operator Example Value Notes
DetFiledAsFamilyLocal = Lauraceae Use this parameter to search for plant family.
DetFiledAsGenusLocal = Nectandra Use this parameter to search for plant genus.
DetFiledAsSpeciesLocal = lanceolata Use this parameter to search for plant species.
DetFiledAsTaxonLocal = Nectandra lanceolata var.parvifolia Mez All or some of the scientific name can be used. Use caution when including authors, however, as the abbreviations must match those in Authors of Plant Names.
DetFiledAsTypeStatus = isotype Other possible values include: type, holotype, syntype, isosyntype, lectotype, etc.
FeaPlantFungDesc = shrub Use this parameter to search for words in the description of the plant or fungus specimen, as typed on the herbarium specimen label.
HabHabitat = south-facing slope Use this parameter to search for words in the description of the habitat where the specimen was collected.
HabSubstrate = sandstone Use this parameter to search for words in the description of the substrate (type of soil or rock, or in the case of parasitic plants and fingi, the host plant) on which the specimen was collected.
HabVegetation = oak Use this parameter to search for words in the description of associated vegetation growing in the vicinity of the collected specimen as noted on the specimen label.
ColCollectionNumberLocal = 17444 Use this parameter to search for the collection number (fieldbook number) of a specimen.