Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Strategy, Code of conduct & Contribution Guide #2946

Draft
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

anthonysena
Copy link
Collaborator

Initial draft for review of #2903

@anthonysena anthonysena linked an issue Jul 9, 2024 that may be closed by this pull request
**ATLAS** is an open source software tool for researchers to conduct scientific analyses on standardized observational data converted to the [OMOP Common Data Model V5](https://github.com/OHDSI/CommonDataModel/wiki "OMOP Common Data Model V5"). Researchers can create cohorts by defining groups of people based on an exposure to a drug or diagnosis of a particular condition using healthcare claims data. ATLAS has vocabulary searching of medical concepts to identify people with specific conditions, drug exposures etc. Patient profiles can be viewed within a specific cohort allowing visualization of a particular subject's health care records. Population effect level estimation analyses allows for comparison of two different cohorts and leverages R packages.
**ATLAS** is an open source software tool for researchers to conduct scientific analyses on patient-level healthcare data standardized to the [OMOP Common Data Model V5](https://ohdsi.github.io/CommonDataModel/ "OMOP Common Data Model V5"). Researchers can create cohorts by defining groups of people based on an exposure to a drug or diagnosis of a particular condition using healthcare claims data. ATLAS has vocabulary searching of medical concepts to identify people with specific conditions, drug exposures etc. More information on ATLAS is found in [Chapter 8 in the Book of OHDSI](https://ohdsi.github.io/TheBookOfOhdsi/OhdsiAnalyticsTools.html).

The vision for ATLAS is to provide a common set of study design tools that are capable of running one or more [HADES](https://ohdsi.github.io/Hades/) analytical R packages.
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Another vision/thought on this: ATLAS is a design tool that supports the OHDSI communities standards & best practices for designing observational studies.


## 2. Who are the project's users?

ATLAS/WebAPI's users are researchers (individuals and teams) who want to design cohort definitions. They will then use these cohort definitions to run analytics to perform characterization, and population-level effect estimation and patient-level prediction for these populations of patients.
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Clean up grammar and remove for these populations of patients


## 3. How do you engage with your user base today?

Users of ATLAS are encouraged to participate in the [ATLAS/WebAPI Working group](https://www.ohdsi.org/workgroups/).
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Call out the OHDSI forums and link to forums.ohdsi.org.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also add a note about forming a new working group focused on the users of this tool in 2025.


- **ATLAS for phenotype development and evaluation**: ATLAS will provide a cohesive set of features for phenotype development and storage.
- **ATLAS for study design and execution via Arachne & Strategus**: currently cohorts are the only reusable element of design that is produced by ATLAS for consumption in Strategus. We should aim to make all of the Strategus HADES modules available for design in ATLAS. We should also have a documented solution for running Strategus via Arachne integrated with ATLAS.
- **Modernize the application stack**: ATLAS/WebAPI has fallen behind on some core libraries which require prioritization to fix.
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add some information on the future roadmap as discussed in the ATLAS WG.


## 7. Who are your key stakeholders?

Researchers who want to design observational studies using the OMOP CDM.
Copy link
Collaborator Author

@anthonysena anthonysena Dec 3, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What is a stakeholder? A person with an interest or concern in something, especially a business.

"Organizations that are contributing resources towards maintaining and improving the functionality of ATLAS through collaboration in OHDSI"

Note here: maybe describe the high-level stakeholders - pharma companies, service providers, academic institutions, etc.


## Development Setup

To set up the development environment for OHDSI Atlas, follow the instructions in the [development setup guide](link-to-development-setup).
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note to self: put together a developer setup guide.


## Coding Guidelines

Please adhere to the [coding guidelines](link-to-coding-guidelines) when contributing code. These guidelines help maintain a consistent codebase and ensure readability.
Copy link
Collaborator Author

@anthonysena anthonysena Dec 3, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pending work will introduce an editor.config which will detail code styling.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Roadmap & contribution guide
1 participant