# Researcher Guide

## Introduction to the Researcher Environment

Welcome to the Animal Genetics Research Platform's Researcher Environment. This guide provides comprehensive information on how to leverage the platform's powerful tools for animal genetics research, breeding program design, and collaboration with the farming community.

## Getting Started as a Researcher

### Setting Up Your Research Profile

1. Complete your researcher profile with:
   * Research specializations and interests
   * Institutional affiliations
   * Publication history
   * Collaboration preferences
2. Configure your notification preferences for:
   * New datasets in your area of interest
   * Collaboration requests
   * Research environment updates
   * Publication opportunities

### Navigating the Researcher Dashboard

Your personalized dashboard provides:

* Recent activity on your research projects
* Notifications about collaborator actions
* Upcoming deadlines and milestones
* Quick access to frequently used tools
* Recommended datasets and literature

## Genomic Analysis Tools

### Accessing Research Environments

The platform provides two primary research environments:

#### RStudio Server

Ideal for statistical genetics analysis with:

* Pre-installed packages for animal genetics (ASReml-R, rrBLUP, etc.)
* Integration with the platform's sheep genetics database
* Collaborative coding capabilities
* Version control for analysis scripts

To launch RStudio:

1. Navigate to "Research Tools" in the main menu
2. Select "Launch RStudio"
3. Choose your configuration options
4. Click "Start Session"

#### JupyterHub

Perfect for Python-based genomic analysis with:

* Pre-configured kernels for bioinformatics
* Interactive visualization capabilities
* Notebook sharing and collaboration
* GPU acceleration for machine learning tasks

To launch JupyterHub:

1. Navigate to "Research Tools" in the main menu
2. Select "Launch JupyterHub"
3. Choose your computational resources
4. Click "Start Notebook"

### Working with Genetic Data

#### Accessing the Sheep Genetics Database

The platform provides access to comprehensive sheep genetic data:

1. Navigate to "Data Sources" in the main menu
2. Select "Sheep Genetics Database"
3. Use the query builder to filter data by:
   * Breed
   * Trait of interest
   * Geographic region
   * Time period
4. Export selected data to your research environment

#### Importing External Datasets

You can integrate external genetic data with platform resources:

1. Navigate to "Data Management" in the main menu
2. Select "Import Dataset"
3. Upload your data files
4. Map your data schema to platform standards
5. Set appropriate sharing and access controls

#### Data Visualization Tools

Specialized visualization tools for genetic data include:

* Pedigree visualization for complex breeding relationships
* Genomic browser for sequence-level exploration
* Trait correlation matrices
* Breeding value distribution charts
* Multi-trait selection index visualizations

## Breeding Program Design

### Simulation Tools

Design and test breeding strategies with simulation tools:

1. Navigate to "Breeding Tools" in the main menu
2. Select "Breeding Simulation"
3. Configure parameters:
   * Base population characteristics
   * Selection criteria and intensity
   * Mating design
   * Number of generations
4. Run simulations and analyze outcomes
5. Compare alternative breeding strategies

### Heritability Analysis

Estimate genetic parameters for traits of interest:

1. Navigate to "Analysis Tools" in the main menu
2. Select "Heritability Analysis"
3. Choose your dataset and trait definitions
4. Select appropriate statistical models
5. Run analysis and interpret results
6. Export findings to your research environment

### Mating Optimization

Develop optimal mating plans for genetic improvement:

1. Navigate to "Breeding Tools" in the main menu
2. Select "Mating Optimization"
3. Import your candidate animal data
4. Define breeding objectives and constraints
5. Run optimization algorithms
6. Review and export mating recommendations

## Collaboration Tools

### Working with Farmers

Engage with livestock producers through:

* Breeding program participation invitations
* Simplified research findings for farmer audiences
* Direct messaging and discussion forums
* Collaborative data collection protocols
* Feedback collection on genetic line performance

To create a farmer collaboration:

1. Navigate to "Collaborations" in the main menu
2. Select "New Farmer Collaboration"
3. Define collaboration parameters and goals
4. Invite relevant farmers
5. Set up data collection protocols

### Research Team Collaboration

Collaborate with other researchers through:

* Shared project spaces with access controls
* Collaborative code editing in research environments
* Dataset sharing with appropriate attribution
* Publication co-authoring tools
* Research workflow management

To create a research collaboration:

1. Navigate to "Collaborations" in the main menu
2. Select "New Research Collaboration"
3. Define project scope and objectives
4. Invite collaborators and assign roles
5. Set up shared resources and workflows

## Knowledge Dissemination

### Creating Farmer-Friendly Summaries

Translate your research for practical application:

1. Navigate to "Knowledge Sharing" in the main menu
2. Select "Create Farmer Summary"
3. Link to your research findings
4. Use the guided template to simplify technical concepts
5. Add visual aids and practical recommendations
6. Publish to the farmer knowledge base

### Publishing Research Findings

Share your research through the platform:

1. Navigate to "Publications" in the main menu
2. Select "New Research Publication"
3. Upload manuscripts or link to external publications
4. Add supplementary materials and datasets
5. Set appropriate access controls
6. Track impact and engagement metrics

## Using Emilia AI for Research

Leverage AI assistance for your research:

* Literature review and summarization
* Experimental design suggestions
* Statistical analysis guidance
* Interpretation of complex genetic results
* Drafting methods sections
* Troubleshooting analytical procedures

To use Emilia AI:

1. Click the Emilia AI icon in any screen
2. Ask your research question in natural language
3. Upload relevant data or images if needed
4. Review and save important responses
5. Provide feedback to improve future assistance

## Advanced Features

### High-Performance Computing

Access additional computational resources for intensive analyses:

1. Navigate to "Research Tools" in the main menu
2. Select "HPC Resources"
3. Request computational allocation
4. Configure job parameters
5. Submit and monitor processing jobs

### Custom Tool Integration

Integrate specialized tools into your workflow:

1. Navigate to "Research Tools" in the main menu
2. Select "Custom Tool Integration"
3. Choose from available integration options
4. Configure connection parameters
5. Test and save your integration

## Best Practices

### Data Management

* Document all datasets with comprehensive metadata
* Version control your analysis scripts and datasets
* Implement consistent naming conventions
* Back up important research outputs
* Follow FAIR principles (Findable, Accessible, Interoperable, Reusable)

### Collaboration Etiquette

* Clearly define roles and responsibilities
* Establish communication protocols
* Set realistic timelines and milestones
* Acknowledge all contributions appropriately
* Provide constructive feedback

### Research Reproducibility

* Document all analysis steps thoroughly
* Capture computational environment details
* Use version control for code and data
* Publish analysis notebooks alongside results
* Include seed values for stochastic processes

## Getting Help

For assistance with the researcher environment:

* Access the Researcher Knowledge Base
* Consult the API documentation
* Ask Emilia AI for guidance
* Join the researcher community forum
* Contact platform support for complex issues

## Next Steps

To deepen your expertise with the platform:

1. Complete the advanced researcher tutorials
2. Join a research community of practice
3. Participate in platform webinars and workshops
4. Explore example research projects and workflows
5. Connect with other researchers in your field


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://naratech-platforms.gitbook.io/animal-research-hub/user-guide/researcher.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.