Table: `ndb.repositoryspecimens`#

Description#

This table lists the repositories in which fossil specimens have been accessioned or reposited. The inventory in Neotoma is by Dataset, which is the collection of specimens from a Collection Unit. Occasionally, specimens from a single Collection Unit have been reposited at different institutions, in which case multiple records for that Dataset occur in the table.

TODO: Expand this description with: - What data does this table store? - What is the business/research purpose? - How is this data collected or generated? - Are there any important caveats or data quality issues?

Table Structure#

Schema: ndb | Table Comment: This table lists the repositories in which fossil specimens have been accessioned or reposited. The inventory in Neotoma is by Dataset, which is the collection of specimens from a Collection Unit. Occasionally, specimens from a single Collection Unit have been reposited at different institutions, in which case multiple records for that Dataset occur in the table.

Statistics#

Metric	Value
Row Count	7,104
Total Size	2144 kB
Table Size	416 kB
Indexes Size	1696 kB

Relationships#

Primary Key: datasetid, repositoryid

Foreign Keys:

datasetid → datasets.datasetid
repositoryid → repositoryinstitutions.repositoryid

Referenced By:

TODO: Document which tables reference this table (will be auto-detected in validation).

Data Dictionary#

Column	Type	Nullable	Default	Constraints	Description
`datasetid`	integer	✗	`-`	FOREIGN KEY, PRIMARY KEY	Dataset identification number. Field links to the Datasets table.
`repositoryid`	integer	✗	`-`	FOREIGN KEY, PRIMARY KEY	Repository identification number. Field links to the RepositoryInstitutions lookup table.
`notes`	text	✓	`-`	-	Free form notes or comments about the disposition of the specimens.
`recdatecreated`	timestamp without time zone	✗	`timezone('UTC'::text, now())`	-
`recdatemodified`	timestamp without time zone	✗	`-`	-

TODO: Review column descriptions and add comments where missing.

Usage Examples#

Example 1: Basic Selection#

-- Get recent records from repositoryspecimens
SELECT *
FROM repositoryspecimens
ORDER BY datasetid DESC
LIMIT 10;

Purpose: Retrieve the 10 most recent records from repositoryspecimens

Example 2: Count Records#

-- Count total records
SELECT COUNT(*) as total_records
FROM repositoryspecimens;

Purpose: Get the total number of records in repositoryspecimens

Example 3: Filter by Date Range#

-- Get records within a date range
SELECT *
FROM repositoryspecimens
WHERE recdatecreated >= '2024-01-01'
  AND recdatecreated < '2025-01-01'
ORDER BY recdatecreated DESC;

Purpose: Retrieve records from repositoryspecimens within a specific date range

Example 4: Join with datasets#

-- Join with related table
SELECT 
    t1.*,
    t2.*
FROM repositoryspecimens t1
INNER JOIN datasets t2 
    ON t1.datasetid = t2.datasetid
LIMIT 100;

Purpose: Retrieve repositoryspecimens records with related data from datasets

Example 5: Aggregate Data#

-- Aggregate records by repositoryid
SELECT 
    repositoryid,
    COUNT(*) as count
FROM repositoryspecimens
GROUP BY repositoryid
ORDER BY count DESC
LIMIT 10;

Purpose: Count records grouped by repositoryid

TODO: Add more specific examples relevant to common research questions or operational tasks.

Data Quality Notes#

TODO: Document: - Known data quality issues - Validation rules - Expected data ranges - Update frequency and mechanisms - Any ETL processes that populate this table

Maintenance#

Data Owner: TODO: Assign owner
Update Frequency: TODO: Document frequency
Last Major Schema Change: TODO: Document when schema last changed

Table: ndb.repositoryspecimens#