# Occam Technology - Full Documentation

## About
Occam Technology (formerly Wiltshire Geological Services) has operated since 1969 from Adelaide, South Australia. We maintain the largest private well log archive in Australasia. 12,000+ wells across Australia, New Zealand, Timor-Leste, and Papua New Guinea.

## Data Offering
- **Archive Size**: 12,000+ petroleum wells
- **Format**: LAS (Log ASCII Standard), workstation-ready digital well log data
- **Geographic Coverage**: Australia (all states/territories), New Zealand, Timor-Leste, Papua New Guinea
- **Temporal Coverage**: 1969 to present
- **Data Types**: Wireline logs (gamma ray, resistivity, sonic, density, neutron), MWD/LWD, core analysis, completion data, deviation surveys
- **Quality**: All data undergoes proprietary QC processing before delivery

## Products
### Digital Well Logs (LAS)
Quality-controlled wireline log data. Available per-well or in bulk for basin studies.

### Well Data Summaries (WDS)
Condensed extracts from well completion reports including analytical data, drilling reports, formation tops, and deviation surveys. Available as structured text files.

## Services
- **Digitisation**: Convert print or image wireline logs to digital LAS format
- **Quality Control**: Depth-match, splice, and validate existing digital log data
- **Reformatting**: Convert between DLIS, LIS, and LAS formats
- **Custom Services**: Bespoke data packages for basin studies, CCS site assessment, and geothermal projects

## Ordering Process
1. **Search**: Use the interactive map at https://www.occam.com.au/map or browse by state/basin at https://www.occam.com.au/wells
2. **Request a Quote**: Add wells to your inquiry cart and submit, or contact us at hello@occam.com.au
3. **Receive Data**: QC'd data delivered digitally within a few business days (quotes issued within 1 business day)

## Pricing
Quote-based. Pricing depends on data type, volume, and processing requirements. Contact hello@occam.com.au for quotes.

## Key Pages
- https://www.occam.com.au/ - Homepage with archive overview
- https://www.occam.com.au/data-archive - Browse the well log collection by basin
- https://www.occam.com.au/map - Interactive map with filtering by state, basin, operator, depth, date, and spatial drawing tools
- https://www.occam.com.au/services - Digitisation, QC, and reformatting services
- https://www.occam.com.au/how-it-works - Three-step ordering process
- https://www.occam.com.au/well-data-summaries - Well Data Summary product details
- https://www.occam.com.au/faq - 14 frequently asked questions
- https://www.occam.com.au/contact - Contact form and enquiry submission
- https://www.occam.com.au/sample-data - Free sample LAS files (Bilyara 1 well)
- https://www.occam.com.au/glossary - Well log terminology reference

## URL Patterns
- https://www.occam.com.au/wells - All wells index (browse by state)
- https://www.occam.com.au/wells/{state} - Wells in a state (e.g., /wells/western-australia)
- https://www.occam.com.au/wells/{state}/{basin} - Wells in a basin (e.g., /wells/western-australia/carnarvon-basin)
- https://www.occam.com.au/wells/{state}/{basin}/{well} - Individual well detail page
- https://www.occam.com.au/basin/{basin} - Basin landing page (cross-state)
- https://www.occam.com.au/operators - All operators hub
- https://www.occam.com.au/operators/{slug} - Wells by operator
- https://www.occam.com.au/drillers - All drillers hub
- https://www.occam.com.au/drillers/{slug} - Wells by driller
- https://www.occam.com.au/rigs - All rigs hub
- https://www.occam.com.au/rigs/{slug} - Wells by rig

## Machine-Use Policy

Short version: the catalogue is open, the log data is not.

**Permitted without asking us**
- Search engine indexing of any public page
- Retrieval and citation of public pages by AI assistants and answer engines
- Use of the public catalogue metadata below, including as AI training input
- Automated access to the endpoints below, within the rate limits

**Requires a licence** (email hello@occam.com.au)
- Bulk extraction or systematic replication of the catalogue, in whole or in substantial part
- Any use of the well log data, curve data, or well data summaries themselves. These are NOT
  served by this API; the endpoints below return descriptive metadata only
- Redistribution or resale of purchased data

**Rate limits**
Requests are rate-limited per client. Treat HTTP 429 as "slow down and retry later", not as an
error to work around. Evading limits, or crawling at a volume that degrades the site for others,
is not permitted. If you need bulk or sustained access, ask us and we will licence it.

Full terms: https://www.occam.com.au/terms (section 4)

## Public API Endpoints

All endpoints below are read-only and return descriptive catalogue metadata.

### GET https://www.occam.com.au/api/wells/map
Returns well locations for map display. Supports extensive filtering.
Parameters: search, states[], basins[], operators[], permits[], drillers[], rigs[], min_depth, max_depth, spud_date_from, spud_date_to, compln_date_from, compln_date_to, wds[], spatial_type, spatial_data, curve_groups[]
Returns: [{"Well_Name": str, "Lat": float, "Lon": float, "Basin_Primary": str}]

### GET https://www.occam.com.au/api/wells/suggest?q={query}
Autocomplete well name suggestions. Supports % wildcard.
Parameters: q (min 1 char), limit (1-50, default 10)
Returns: [str]

### GET https://www.occam.com.au/api/wells/operators/search?q={query}
Search operators for autocomplete.
Parameters: q (min 2 chars)
Returns: [str]

### GET https://www.occam.com.au/api/wells?page={n}&page_size={n}
Paginated well list with basic filters.
Parameters: page, page_size (10-100), search, state, basin, operator, classification, min_depth, max_depth
Returns: {"wells": [...], "total": int, "page": int, "page_size": int, "total_pages": int}

### GET https://www.occam.com.au/api/wells/stats
Quick statistics.
Returns: {"wells": int, "basins": int}

### GET https://www.occam.com.au/api/wells/{well_name}
Full details for a single well.
Returns: Well object with name, state, basins, coordinates, depth, dates, operator, driller, rig, classification, status, shows, data availability

### GET https://www.occam.com.au/api/wells/{well_name}/data
Available log data for a well: streams, traces, curve groups, depth ranges.
Returns: {"well_name": str, "stream_count": int, "trace_count": int, "data_points": int, "streams": [...], "traces_by_group": {...}}

### GET https://www.occam.com.au/api/wells/filters/options
Distinct values for all filter dropdowns (states, basins, operators, permits, drillers, rigs, curve groups, depth range).

### GET https://www.occam.com.au/api/basins
All basins with well counts and geographic bounds (5-minute cache).

### GET https://www.occam.com.au/api/search?q={query}
Global search across wells, basins, and operators.
Parameters: q (min 2 chars), limit (1-50, default 20)
Returns: {"results": [{"type": str, "title": str, "subtitle": str, "url": str}]}

### GET https://www.occam.com.au/api/basin/{basin_name}/wells
Wells for a specific basin with pagination.
Parameters: limit (1-100, default 10), offset (default 0)

## Spatial Filtering
The /api/wells/map endpoint supports spatial filters via spatial_type and spatial_data parameters:
- Circle: spatial_type=circle, spatial_data={"center": [lon, lat], "radius_m": meters}
- Polygon: spatial_type=polygon, spatial_data={"coordinates": [[lon, lat], ...]}
- Rectangle: spatial_type=rectangle, spatial_data={"bounds": [[sw_lat, sw_lng], [ne_lat, ne_lng]]}

## Contact
- Email: hello@occam.com.au
- Website: https://www.occam.com.au/contact
- Location: Adelaide, South Australia