Skip to main content

SDL User Guide

Welcome to the Scientific Data Layer (SDL) platform! This guide helps researchers, data curators, content authors, and collaborators navigate and use SDL effectively for managing scientific data and workflows.

SDL provides a unified interface for organizing research data using semantic web technologies, enabling FAIR data principles, collaborative workspaces, and rich metadata management across scientific domains.

Getting Started

Accessing SDL

SDL platforms are typically hosted by research institutions and provide web-based access to scientific data management tools. Contact your system administrator for:

  • Login credentials and workspace access
  • Platform URL and connection details
  • Initial workspace assignment and permissions

First Login

Upon logging in, you'll see:

  • Workspace dashboard - Your assigned projects and collaborative spaces
  • Navigation sidebar - Quick access to data collections, workflows, and tools
  • Content browser - Semantic organization of datasets, documents, and resources
  • Activity feed - Recent changes and collaborative updates

Core Concepts

Workspaces

Workspaces are collaborative environments where research teams organize projects, data, and workflows:

  • Project Workspaces - Dedicated spaces for research initiatives
  • Data Collections - Organized datasets with semantic metadata
  • Collaborative Editing - Real-time content creation and annotation
  • Access Control - Role-based permissions for team members

Semantic Content

SDL organizes information using semantic web standards, providing:

  • Typed Content Blocks - Structured data with defined meanings
  • Ontology Integration - Standard vocabularies for scientific domains
  • Linked Data - Connections between related concepts and datasets
  • Provenance Tracking - Complete history of data creation and modification

FAIR Principles

SDL implements FAIR data practices:

  • Findable - Rich metadata and semantic search capabilities
  • Accessible - Standardized interfaces and data formats
  • Interoperable - RDF standards and ontology alignment
  • Reusable - Clear licensing and comprehensive documentation

Working with Data

Creating Content

Data Upload and Import

  1. Navigate to workspace - Select your target project workspace
  2. Choose content type - Select from available semantic templates
  3. Upload files - Drag and drop or browse for data files
  4. Add metadata - Complete required fields using guided forms
  5. Semantic annotation - Tag content with domain-specific terms

Structured Content Creation

SDL provides templates for common scientific content types:

  • Experimental Procedures - Step-by-step protocol documentation
  • Dataset Descriptions - Comprehensive metadata for research data
  • Analytical Results - Structured reporting of measurements and observations
  • Literature References - Bibliographic information with semantic links

Content Organization

Hierarchical Structure

Organize content using semantic relationships:

  • Collections - Group related datasets and documents
  • Categories - Domain-specific classification schemes
  • Tags and Keywords - Flexible labeling system
  • Relationships - Explicit connections between resources

Search and Discovery

Find content using multiple approaches:

  • Semantic Search - Query using domain terminology and concepts
  • Faceted Browsing - Filter by content type, date, author, or domain
  • Graph Navigation - Explore connections between related resources
  • Full-text Search - Traditional keyword-based content discovery

Data Annotation

Metadata Management

Enhance data discoverability through rich metadata:

  • Descriptive Metadata - Title, abstract, keywords, and descriptions
  • Administrative Metadata - Creation date, author, permissions, and version
  • Structural Metadata - File formats, relationships, and organization
  • Technical Metadata - Instrument settings, software versions, and protocols

Ontology Integration

SDL leverages standard vocabularies:

  • Domain Ontologies - Specialized terms for chemistry, materials science, etc.
  • Upper Ontologies - General concepts like time, space, and causation
  • Provenance Models - Track data creation, modification, and analysis workflows
  • Measurement Standards - Units, quantities, and observational metadata

Collaboration Features

Team Workspaces

Collaborate effectively with research partners:

  • Shared Collections - Common access to project datasets
  • Role-based Permissions - Control editing and viewing rights
  • Activity Notifications - Stay informed about workspace changes
  • Version Control - Track content evolution and maintain history

Content Editing

Work together on research documentation:

  • Collaborative Editing - Multiple users editing content simultaneously
  • Comment and Review - Provide feedback and suggestions on content
  • Approval Workflows - Structured review and publication processes
  • Change Tracking - Comprehensive audit trail of modifications

Communication Tools

Stay connected with team members:

  • Workspace Chat - Discuss project details and coordinate activities
  • Annotation Comments - Context-specific discussions on data and content
  • Activity Streams - Follow updates and changes across workspaces
  • Notification Settings - Customize alerts for relevant events

Platform-Specific Features

Laboratory Integration

For experimental platforms like ACL (Automated Chemistry Lab):

  • Instrument Data Import - Direct integration with analytical equipment
  • Experiment Tracking - Link protocols, samples, and results
  • Provenance Capture - Automatic recording of experimental workflows
  • Quality Control - Validation and review processes for experimental data

Data Analysis Workflows

SDL platforms often provide:

  • Computational Notebooks - Jupyter integration for data analysis
  • Visualization Tools - Interactive charts and scientific plotting
  • Statistical Analysis - Built-in tools for common research methods
  • Machine Learning - AI/ML pipeline integration for discovery workflows

External System Integration

Connect SDL with existing research infrastructure:

  • LIMS Integration - Laboratory Information Management Systems
  • Instrument APIs - Direct data acquisition from scientific equipment
  • Repository Sync - Integration with institutional data repositories
  • Publication Workflows - Export to manuscript and publication systems

Content Types and Templates

Experimental Data

Structure laboratory and computational experiments:

  • Protocol Documentation - Step-by-step experimental procedures
  • Sample Metadata - Comprehensive sample characterization
  • Measurement Data - Structured recording of observations and results
  • Analysis Reports - Interpretation and conclusions from experiments

Research Documentation

Organize project information and findings:

  • Project Descriptions - Goals, hypotheses, and research questions
  • Literature Reviews - Systematic organization of relevant publications
  • Meeting Notes - Collaborative documentation of discussions and decisions
  • Progress Reports - Structured updates on research advancement

Data Management

Handle research data systematically:

  • Data Management Plans - Documentation of data handling procedures
  • Dataset Catalogs - Comprehensive listings of available research data
  • Backup and Archive - Long-term preservation and access strategies
  • Sharing Agreements - Documentation of data use and collaboration terms

Best Practices

Data Quality

Maintain high standards for research data:

  • Complete Metadata - Fill all required fields and provide rich descriptions
  • Consistent Naming - Use standardized file and content naming conventions
  • Regular Validation - Periodically review and update content for accuracy
  • Documentation Standards - Follow institutional and domain-specific guidelines

Collaboration Etiquette

Work effectively with team members:

  • Clear Communication - Provide context and rationale for changes
  • Timely Updates - Keep content current and respond to collaboration requests
  • Respect Permissions - Honor access controls and editing responsibilities
  • Constructive Feedback - Provide helpful comments and suggestions

Information Security

Protect sensitive research data:

  • Access Controls - Use appropriate permissions for confidential content
  • Regular Backups - Ensure critical data is properly preserved
  • Secure Sharing - Follow institutional policies for data distribution
  • Incident Reporting - Report security concerns to system administrators

Troubleshooting

Common Issues

Login and Access Problems

  • Forgotten Password - Use institutional password reset procedures
  • Permission Denied - Contact workspace administrators for access requests
  • Network Issues - Verify institutional network connectivity and VPN requirements

Content Management Issues

  • Upload Failures - Check file size limits and supported formats
  • Missing Metadata - Review required fields and validation messages
  • Synchronization Problems - Refresh browser and check network connectivity

Collaboration Conflicts

  • Edit Conflicts - Use version control to resolve competing changes
  • Permission Issues - Verify role assignments and workspace access
  • Notification Problems - Check user preferences and email settings

Getting Help

Documentation Resources

  • Platform-Specific Guides - Detailed documentation for your SDL installation
  • Video Tutorials - Step-by-step demonstrations of common workflows
  • FAQ Collections - Answers to frequently asked questions
  • Best Practice Guides - Recommendations for effective SDL usage

Support Channels

  • Help Desk - Contact institutional support for technical assistance
  • User Communities - Connect with other SDL users for tips and advice
  • Administrator Contact - Reach platform administrators for access and permission issues
  • Developer Forums - Technical discussions and feature requests

Advanced Features

API Access

For programmatic interaction with SDL:

  • REST APIs - Standard HTTP interfaces for data access and manipulation
  • GraphQL Endpoints - Flexible query interfaces for complex data retrieval
  • Authentication - Token-based access for automated workflows
  • Documentation - Comprehensive API reference and examples

Custom Integrations

Extend SDL functionality:

  • Plugin Development - Create custom content types and workflows
  • External Tool Integration - Connect SDL with specialized research software
  • Data Pipeline Automation - Automate repetitive data processing tasks
  • Reporting and Analytics - Generate custom reports and visualizations

Administrative Tasks

For workspace managers and administrators:

  • User Management - Add, remove, and manage team member access
  • Workspace Configuration - Customize settings and templates
  • Content Moderation - Review and approve published content
  • Performance Monitoring - Track usage and system performance metrics

Need additional help? Contact your platform administrator or visit the developer documentation for technical details and integration guidance.