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

more details to the documentation of data preprocessing #94

Merged
merged 6 commits into from
Dec 9, 2024

Conversation

Mivg
Copy link
Collaborator

@Mivg Mivg commented Nov 17, 2024

No description provided.

@Mivg Mivg self-assigned this Nov 17, 2024
README.md Outdated
@@ -98,11 +98,11 @@ To get started with DCLM, follow these steps:
We recommend the use of Python 3.10 with DCLM.

## Selecting Raw Sources
If you are creating a new source:
If you are creating a new source (for example, Wikipedia, GitHub, etc.):
Copy link
Contributor

Choose a reason for hiding this comment

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

Maybe creating -> registering?

README.md Outdated
- Key names should be consistent with those in [here](baselines/core/constants.py).
- Create a reference JSON in [exp_data/datasets/raw_sources](exp_data/datasets/raw_sources).
- Ensure your data is stored in JSONL format (ideally compressed with zstandard), where each line correspond to single page.
- Key names in these JSONL should be consistent with those in [here](baselines/core/constants.py).
Copy link
Contributor

Choose a reason for hiding this comment

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

Maybe we can explain these in bit more detail here?

@@ -119,6 +119,7 @@ To process raw data, follow these steps:

2. **Set up a Ray cluster**:
The data processing script relies on Ray for distributed processing of data. This cluster can be either launched on a single node (for small scale data processing) or using AWS EC2 instances.
There is also work to [deploy Ray on slurm setups](https://docs.ray.io/en/latest/cluster/vms/user-guides/community/slurm.html), though this effort is still a work-in-progres.
Copy link
Contributor

Choose a reason for hiding this comment

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

I feel like this isn't really WIP anymore, in the sense that it is possible to do so if you follow the guide.

Copy link
Contributor

Choose a reason for hiding this comment

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

has one of us been able to get our scripts to work on slurm?

Copy link
Contributor

Choose a reason for hiding this comment

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

I've been launching Ray jobs on TACC, so that part is stable - but I suppose you're right, best not to claim something that might be false

@jeffreywpli jeffreywpli force-pushed the fix/additional_documentation branch from 405842b to 57e0151 Compare December 7, 2024 01:26
README.md Outdated
- Key names should be consistent with those in [here](baselines/core/constants.py).
- Create a reference JSON in [exp_data/datasets/raw_sources](exp_data/datasets/raw_sources).
- Ensure your data is stored in JSONL format, ideally compressed with zstandard (though uncompressed or gzip-compressed files will also work), where each line corresponds to a single page/document.
- Key names in these JSONL should be consistent with those in [here](baselines/core/constants.py). Most importantly, there should be a ``"text"`` key for each line that contains the acftual content of the page.
Copy link
Contributor

Choose a reason for hiding this comment

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

typo: acftual - > actual

README.md Outdated
- Key names should be consistent with those in [here](baselines/core/constants.py).
- Create a reference JSON in [exp_data/datasets/raw_sources](exp_data/datasets/raw_sources).
- Ensure your data is stored in JSONL format, ideally compressed with zstandard (though uncompressed or gzip-compressed files will also work), where each line corresponds to a single page/document.
- Key names in these JSONL should be consistent with those in [here](baselines/core/constants.py). Most importantly, there should be a ``"text"`` key for each line that contains the acftual content of the page.
Copy link
Contributor

Choose a reason for hiding this comment

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

I would rephrase as follows:

Each row in these JSONL files corresponds to a document. Each row should contain keys consistent with those at ... and at minimum should contain at least a "text" key containing the actual content.

@GeorgiosSmyrnis GeorgiosSmyrnis merged commit 8383011 into main Dec 9, 2024
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.

4 participants